Appendix A: System Routines — Menus
905
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
PopupNew
Declaration:
HANDLE
PopupNew
(const char *
Title
, short
MaxHeight
)
Category(ies):
Menus
Description:
Begin a dynamically created pop-up returning a handle to an empty pop-up
structure or H_NULL if not enough memory. This empty pop-up structure
can be modified with
DynMenuAdd
or
DynMenuChange
. The pop-up can
then be executed with
PopupDo
or if menu features (checkmarks,
enabling or disabling entries) are needed then
PopupBegin
/
PopupBeginDo
can be used.
Inputs:
Title
— Pointer to string for title of pop-up or NULL if no title.
MaxHeight
— Set to 0 for default height (as high as will fit onto the
screen). If > 0 then use it as the maximum height of the
pop-up.
Outputs:
HANDLE to empty POPUP structure or H_NULL if not enough memory.
Assumptions:
None
Side Effects:
May cause heap compression.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: PopupDo, PopupBegin, PopupClear, DynMenuAdd, DynMenuChange
Example:
See
PopupDo
(normal pop-up) or
PopupBegin
(pop-up with menu like
features — enable/disable and checkmarks) for an example.