= FORM_RUN =
Runs a form.

{{{
int FORM_RUN(formName name);
}}}

== Parameters == 

 * formName - name of the form

== Return Value ==

 * Returns a result value based on the input

== Remarks ==

FORM_RUN is a macro to simplify the call to the specified form to start processing input. The preprocessor will convert the code to call to the specified form's Run() function.
{{{
#define FORM_RUN(f)	form##f.Run()
}}}

== 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_INIT FORM_INIT]
 * [wiki:FORM_SHOW FORM_SHOW]
 * [wiki:FORM_ADD_INPUT FORM_ADD_INPUT]