Texas Instruments TI-89 - Popupbegin

900
Appendix A: System Routines — Menus
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
PopupBegin
Declaration:
HANDLE
PopupBegin
(HANDLE
PopupHandle
, SINT
Flags
)
Category(ies):
Menus
Description:
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.
Inputs:
PopupHandle
— HANDLE created by
PopupNew
.
Flags
— None currently used.
Outputs:
Menu-draw HANDLE that is then passed to
PopupBeginDo
.
Assumptions:
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.
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
).
Side Effects:
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)