Popupaddtext - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Menus

PopupAddText

Declaration: HANDLE PopupAddText (HANDLE hPopup , SWORD ParentId ,
const char * Name , short Id )
Category(ies): Menus
Description: PopupAddText is an older version of DynMenuAdd. DynMenuAdd is
more flexible and should be used in general.
Inputs: hPopup
ParentId — 0
Outputs: If successful, hPopup . H_NULL if out of memory or error in parameters
( ParentId not found, ParentId found but it was not a possible parent or the
maximum number of items in a menu was exceeded).
Note that if there is an error adding the new entry, the MF_ERROR bit in
MenuFlags ( hPopup ) is set.
Assumptions: DynMenuAdd is more general purpose and should generally be used
instead of PopupAddText.
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: DynMenuAdd, DynMenuChange, PopupNew
Example: See PopupDo.
TI-89 / TI-92 Plus Developer Guide
— HANDLE returned from PopupNew.
— Top-level entry that can have children.
L1 — Low-level menu item.
> 0 — The given Id is the child of this parent.
Name — Pointer to text string to add.
Id — Menu ID for this entry (1 . . . 0xFFF).
Not for Distribution
899
Beta Version January 26, 2001