Texas Instruments TI-89 - Fkeyi_H

874
Appendix A: System Routines — Menus
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
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.
Inputs:
hMenu
— Handle returned from
MenuBegin
.
Key
— Key code.
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 = 0;
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;
}