Ev_Setfkeystate - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Operating System

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
state
redraw — TRUE
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)
EV_setFKeyState(f, FALSE, FALSE);
EV_setFKeyState(1, TRUE, TRUE);
TI-89 / TI-92 Plus Developer Guide
— Function key number 1 . . . 8.
— TRUE — Enable function key.
FALSE — Disable function key (dim menu title).
— 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.
/* disable all menus */
/* do not redraw the menu bar, yet */
/* enable F1 and redraw the menu bar */
Not for Distribution
925
Beta Version January 26, 2001