Texas Instruments TI89 Developer Guide - Page 942

900 Appendix A: System Routines - Menus PopupBegin Declaration: Category(ies): Description: Inputs: Outputs: Assumptions: HANDLE PopupBegin (HANDLE PopupHandle, SINT Flags) Menus Allocate a menu-draw structure for a dynamic pop-up so that the pop-up items can have the enable / disable or checkmark features of menus. PopupHandle - HANDLE created by PopupNew. Flags - None currently used. Menu-draw HANDLE that is then passed to PopupBeginDo. NOTE: There is a STRICT method of using dynamic popups that use PopupBegin. 1. Create an empty, dynamic pop-up structure with PopupNew. 2. Build the menu with DynMenuAdd (or PopupAddText). 3. Pass the handle returned by PopupNew to PopupBegin. 4. The handle returned by PopupBegin can now be passed to MenuSubStat (PopupSubStat is #defined to this) to enable/disable individual items or MenuCheck (PopupCheck) to turn on/off or test the status of checkmarks for individual items. 5. Pass the handle returned from PopupBegin to PopupBeginDo to actually execute the pop-up. Side Effects: 6. When done with the menu, call MenuEnd on the handle returned from PopupBegin. This will free that handle AND the handle returned from PopupNew. Do not forget that once you call PopupBegin you may not unlock the handle returned from PopupNew or call DynMenuAdd or DynMenuChange (or PopupAddText). May cause heap compression. Availability: On AMS 2.00 and higher. TI-89 / TI-92 Plus Differences: None See Also: PopupNew, PopupBeginDo, MenuSubStat, MenuCheck, MenuEnd (continued) TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001