EV_setFKeyState Function (ROM Call 0xD3)

events.h

void EV_setFKeyState (unsigned short Item, short State, short Redraw);

Changes the status (active/inactive) of a toolbox in the menu associated with current application.

EV_setFKeyState changes the status of the toolbox Item (0 = first, 1 = second etc.) which belongs to the menu associated with the current application (see also MenuTopStat). State is a Boolean value: when it is TRUE, the toolbox will be active, and when it is FALSE, the toolbox will be inactive (i.e. it will be dimmed, and it cannot be selected).

EV_setFKeyState can also force redrawing of the menu after changing state: to do this, set Boolean parameter Redraw to TRUE. Avoid menu redraw flicker when enabling/disabling several function keys by specifying FALSE for redraw in all but the last call to this routine.


Uses: MenuOn, MenuTopStat, CU_cursorState, CU_restore, ROM Call 0x3CD, ROM Call 0x4FB
Used by: cmd_disp, cmd_disphome, cmd_input, cmd_inputstr, cmd_output, cmd_pause, cmd_prompt, HomeExecute


See also: MenuTopStat