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

• FORM_INIT
• FORM_SHOW
• FORM_ADD_INPUT