898
Appendix A: System Routines — Menus
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
MenuTopStat
Declaration:
void
MenuTopStat
(HANDLE
MenuHandle
, SINT
Index
, SINT
Status
)
Category(ies):
Menus
Description:
Enable/Disable a top-level menu item.
Inputs:
MenuHandle
— Menu-draw handle from
MenuBegin
.
Index
— 0 . . . number of top-level menu items less one (not all
items may be displayed at once depending on how
many there are, their size and the size of the screen).
Status
— If Status is TRUE the item is enabled (normal text/icon,
can be selected) otherwise it is disabled (grayed-out
text/icon, cannot be selected).
Outputs:
None
Assumptions:
The effects of enabling or disabling a top-level menu item are not drawn
until
MenuOn
is called to redraw the menu. Note in the following example
that
MenuOn
is called after
MenuTopStat
(there could have been several
MenuTopStat
calls) and before
MenuKey
.
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: MenuSubStat
(for sublevel items)
Example:
HANDLE hMenu;
if (hMenu = MenuBegin( &SelectMenu, 0, 0, 0 )) {
MenuCheck( hMenu, MID_SUB1, MC_CHECK ); /* Check SUB1 */
MenuKey( hMenu, KB_F1 );
MenuTopStat( hMenu, 1, FALSE ); /* Disable TOP item "SECOND" */
MenuSubStat( hMenu, MID_SUB2, FALSE ); /* Disable submenu item "SUB2" */
MenuCheck( hMenu, MID_SUB1, MC_FLIP ); /* Uncheck SUB1 */
MenuOn( hMenu ); /* so top-level redrawn */
MenuKey( hMenu, KB_F1 );
MenuEnd( hMenu );
}
TOOLBOX SelectMenu, 0, 0, 240 {
"FIRST", MID_1ST_TOP {
"SUB 1", MID_SUB1
"SUB 2", MID_SUB2
}
"SECOND", MID_2ND_TOP {
"SUB A", MID_SUBA
}
}
To Next Page
Loading...
Need help?
General
