EV_setCmdState Function (ROM Call 0xD2)

events.h

void EV_setCmdState (unsigned short cmd, short State);

Changes the status (active/inactive) of a menu command in the current application.

EV_setCmdState is similar to EV_setFKeyState, but works with command pulldown menus associated with the main toolbar menu which belongs to the current application. EV_setCmdState changes the status of the command item which has its ret_val (see EV_registerMenu) equal to the cmd. For example, if you execute

EV_setCmdState (CM_MENU_CUT, FALSE);
in your program, you will see that the "Cut" command in the "Home screen" menu will be disabled (note that "Home screen" is the current application if you didn't use EV_startApp in your program). CM_MENU_CUT is, of course, the code of the "Cut" menu command.


Uses: MenuSubStat, ROM Call 0x3CD
Used by: cmd_disphome, HomeExecute, TE_indicateReadOnly


See also: MenuSubStat