Sets the number of menu levels to go up when the data form is called from a menu
| Call | |
| #include <vv_form.h> | |
| void sfm_mnretlevel(retlevel, dfmp) | |
|
int retlevel |
Number of menu levels to go up |
| DFORMPTR dfmp | Pointer to a data form |
| retlevel: Specify one of the following: | |
|
FUNCERROR |
To make an error exit from mn_proc() |
| EXITMENU | To make a normal exit from mn_proc() |
| TOPLEVEL | To go to the top-level menu |
| SAMELEVEL | To stay at the current menu level |
| >=1 | To move up the specified number of menu levels. If this is not possible, the current menu level is set to the top level. |
| Returns
None |
|
| Description
sfm_mnretlevel() sets the return level member of the specified form to the specified value. When the user exits or quits the form, the FORMCALL() action function returns the specified value to the menu editor. The menu editor then acts on the specified return level as listed above. |
|
| Related Functions | |
| Cautions
sfm_mnretlevel() has no effect unless the specified form is called from a menu through FORMCALL(). sfm_mnretlevel() is a macro and does no error checking. Macros are not listed by the VCS error reporting system. |
|
