Using FORMCALL() to Call a Data Form

Menu field:FORMCALL() is used to display and process the data form attached to a menu field. If you use FORMCALL() as the action function, you should specify a pointer to the data form, either for the sub_fmp argument in the mnf_def() call, or in the "Menu Field Basic Information" dialog box in the Designer.

FORMCALL() calls fm_proc() for the data form attached to the current menu field in the current menu form. If fm_proc() fails, FORMCALL() returns FUNCERROR. Otherwise, FORMCALL() returns the menu return level for the data form as stored in the data form structure.

Setting the Menu Return Level

The default menu return level for any form is SAMELEVEL; this is set by default when the form is defined with fm_def() or fm_vdef().

Designer: You can change the menu return level for a data form in the Designer. See the Designer User's Guide for more information. You can also change the menu return level in your code, at any time after reading the form from the Designer library.

Code: To change the menu return level for any form, call the set form menu return level function, sfm_mnretlevel():

void sfm_mnretlevel(retlevel, dfmp)

int retlevel;

/* Return value for FORMCALL()

*/

DFORMPTR dfmp;

/* Data form pointer

*/

For the return value, specify any of the pre-defined values listed in Table 33.1, or specify the number of menu levels to move up.