Texas Instruments TI89 Developer Guide - Page 940

898 Appendix A: System Routines - Menus MenuTopStat Declaration: void MenuTopStat (HANDLE MenuHandle, SINT Index, SINT Status) Category(ies): Menus Description: Inputs: Enable/Disable a top-level menu item. MenuHandle - Menu-draw handle from MenuBegin. Index Status - 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). - 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: Assumptions: None 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 } } TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001