MenuCheck Function (ROM Call 0x37)

menus.h

short MenuCheck (HANDLE ExecHandle, short ID, unsigned short Cmd);

Checks/unchecks or returns the state of an item in a pulldown menu.

MenuCheck checks/unchecks or returns the state of the check mark of the pulldown submenu item identified by ID (see MenuAddText for more details about item IDs). ExecHandle is a handle returned from the MenuBegin function, not from MenuNew.

If Cmd is set to MC_STATUS, MenuCheck returns the status of the check mark (zero: not checked, nonzero: checked). Otherwise it returns TRUE on success (i.e. item was found) and FALSE on failure.

The Cmd parameter must be one of the following values, defined in the enum MenuCheckCmds:

MC_CHECK Display a check mark next to the menu item.
MC_UNCHECK AMS 2.00 or higher: Remove the check mark.
MC_STATUS Return the status of the check mark (zero: not checked, nonzero: checked).
MC_FLIP Invert the status of the check mark.


Uses: ROM Call 0x422
Used by: EV_setCmdCheck


See also: MenuBegin