= FORM_SHOW =
Shows a form.

{{{
void FORM_SHOW(formName name);
}}}

== Parameters == 

 * formName - name of the form

== Return Value ==

This function does not return any value

== Remarks ==

FORM_SHOW is a macro to simplify the initial showing of a form. The preprocessor will convert this to a call to the specified form's Show() function. 
{{{
#define FORM_SHOW(f) form##f.Show()
}}}

== Examples ==

{{{
void IDScreen(void)
{
    string strID = "";
    float fVal = 0.0;

    FORM_INIT(ID, EventIDShow, NULL, NULL, NULL, nFormFlgShowHelp);
    FORM_ADD_INPUT(ID, ID, 0, 50, "ID: ", 10, 0, 0, NULL, strID, 0, NULL, "Enter the ID");
    FORM_ADD_INPUT(ID, Val, 0, 80, "Value: ", 10, 0, 9999, NULL, fVal, 0, NULL, "Enter the value");

    FORM_SHOW(ID);
    FORM_RUN(ID);
    FORM_HIDE(ID);

    // strID and fVal now contain the entered data
}

EVENT(IDShow)
{
    ClearLCD();
    DisplayText(0, 0, "ID/Value Screen");
    return 0;
}
}}}


== See Also ==

 * [wiki:FORM_HIDE FORM_HIDE]
 * [wiki:FORM_INIT FORM_INIT]
 * [wiki:FORM_RUN FORM_RUN]