Fkeyi_H - Texas Instruments TI-89 Developer's Manual

874

FKeyI_H

Declaration: WORD FKeyI_H (HANDLE MenuH , WORD Key )
Category(ies): Menus
Description: For the given function key, return its index relative to KB_F1 (KB_F1 -> 0,
. . . , F8 -> 7) or M_NOTMENUKEY if not a function key.
hMenu — Handle returned from MenuBegin.
Inputs:
Key
Outputs: 0 . . . 7 if menu key or M_NOTMENUKEY. (Note that M_NOTMENUKEY
may be returned for function keys not defined for the given menu handle.)
Assumptions: None
Side Effects: None
Availability: On AMS 2.02 and higher.
TI-89 / TI-92 Plus
Differences: None
See Also: MenuBegin, MenuKey
Example:
HANDLE hMenuDraw;
WORD key, menuSelect
const MENU ToolBox2;
if (hMenuDraw = MenuBegin(&ToolBox2, 0,0, 0 )) {
key = GKeyIn( NULL, 0 );
if (M_NOTMENUKEY == FKeyI_H(hMenuDraw, key))
Disp("Key not on this menu");
else
menuSelect = MenuKey( hMenuDraw, key );
MenuEnd( hMenuDraw );
return menuSelect;
}
TI-89 / TI-92 Plus Developer Guide
— Key code.
= 0;
Not for Distribution
Appendix A: System Routines — Menus
Beta Version January 26, 2001