Texas Instruments TI-89 - Menuitemdef

884
Appendix A: System Routines — Menus
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
MenuItemDef
Declaration:
void *
MenuItemDef
(HANDLE
mH
, WORD
Id
, WORD *
type
)
Category(ies):
Menus
Description:
Given a menu
Id
, return a pointer to the text, ICON, or BITMAP defining it;
NULL if
Id
not found (*
type
set to 0) for a given menu handle. Return its
type in
type
.
Inputs:
mH
— Handle returned from
MenuBegin
for menu to search.
Id
— Menu ID.
Outputs:
Pointer to item’s definition.
*
type
— DMF_TEXT, DMF_ICON, DMF_BITMAP, or 0 if
Id
not found.
Assumptions:
None
Side Effects:
None
Availability:
On AMS 2.00 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: MenuBegin, DynMenuAdd, DynMenuChange
Example:
HANDLE mH;
WORD Id, type;
void *vPtr;
.
.
.
if (Id = MenuKey(mH, KB_F1)) {
if (vPtr = MenuItemDef( mH, Id, &type )) {
/* vPtr points to item selected */
/* type will be DMF_TEXT, DMF_ICON or DMF_BITMAP depending on the type
of the menu item */
.
.
.
}
}