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 can not 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