Appendix A: System Routines — Operating System
925
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
EV_setFKeyState
Declaration:
void
EV_setFKeyState
(USHORT
fkey
, BOOL
state
, BOOL
redraw
)
Category(ies):
Operating System
Description:
Enables or disables a menu function key. A disabled function key is
dimmed in the menu bar and cannot be selected by the user.
Avoid menu redraw flicker when enabling/disabling several function keys
by specifying
Inputs:
fkey
— Function key number 1 . . . 8.
state
— TRUE — Enable function key.
FALSE — Disable function key (dim menu title).
redraw
— TRUE — Redraw menu bar.
FALSE — Do not redraw menu bar.
Avoid menu redraw flicker when enabling/disabling several
function keys by specifying FALSE for
redraw
in all but the
last call to this routine.
Outputs:
None
Assumptions:
This routine uses the menu handle in application frame attribute
OO_APP_DEFAULT_MENU_HANDLE. See section
9.6. Menu
Processing
for guidelines on setting up a menu where default event
handling can find it.
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: EV_setCmdCheck, EV_setCmdState,
section
9.6. Menu Processing
Example:
USHORT f;
for (f = 1; f <= 8; f += 1) /* disable all menus */
EV_setFKeyState(f, FALSE, FALSE); /* do not redraw the menu bar, yet */
EV_setFKeyState(1, TRUE, TRUE); /* enable F1 and redraw the menu bar */