Texas Instruments TI-89 - Menutopredef

894
Appendix A: System Routines — Menus
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
MenuTopRedef
Declaration:
void
MenuTopRedef
(HANDLE
MenuHandle
, SWORD
Index
,
SINT
MenuId
)
Category(ies):
Menus
Description:
Redefine a top-level menu item Icon for a menu that was started with the
MBF_REDEF flag set when
MenuBegin
was called and created with the
resource compiler (using the MF_ALT_ICONS flag). The selected top-level
Icon is redrawn with the Icon of one of its submenus.
Inputs:
MenuHandle
— Handle returned from
MenuBegin
.
Index
— 0 . . . number of top-level items – 1.
MenuId
— New menu ID for the top-level item specified by
Index
.
Note that
MenuId
must be the menu ID for one of the
submenus for the top-level item selected.
Outputs:
None
Assumptions:
MenuHandle
refers to a menu-draw handle with the MBF_REDEF flag bit
set when it was started with
MenuBegin
. Redefinable menus may only be
created with the resource compiler. The redefined item must have text and
an icon defined for it (see example below). The original top-level item may
be defined with the special DUMMY keyword in which case there is no
default selection or it may have a default icon specified and then it will not
have to be initialized with
MenuTopRedef
.
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: MenuBegin, MenuGetTopRedef, MenuTopSelect
(continued)