Appendix A: System Routines — Menus
899
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
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
— HANDLE returned from
PopupNew
.
ParentId
— 0 — Top-level entry that can have children.
L
1 — 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).
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
.