Texas Instruments TI-89 - Menuaddtext

876
Appendix A: System Routines — Menus
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
MenuAddText
Declaration:
HANDLE
MenuAddText
(HANDLE
hMenu
, SWORD
ParentId
,
const char *
Name
, short
Id
, WORD
Flags
);
Category(ies):
Menus
Description:
Add a text entry to a dynamic menu.
Inputs:
hMenu
— Handle to a dynamic menu created with
MenuNew
or
MenuLoad
.
ParentId
— ID of parent if adding a child entry (0 if adding top-level
entry).
Name
— Pointer to ICON.
Id
— ID of new entry. If
Id
is 0 then use sequentially numbered
Ids. IDs are limited to the range 0x0001 . . . 0xFFF (12 bits).
NOTE:
If you are adding to a menu created with the resource compiler (using
MenuLoad
) do NOT use the range F00 . . . FFF.
Flags
— Must be one of the following:
DMF_TOP — New top-level entry that cannot be a
parent.
DMF_TOP_SUB — New top-level entry that can have
children.
DMF_CHILD — Child of parent (as specified by
ParentId
).
DMF_CILD_SUB — Child of parent (
ParentId
) that can
also have children.
Outputs:
hMenu
if successful, H_NULL if out of memory or error in parameters.
Assumptions:
None
Side Effects:
May compress the heap.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: MenuNew, MenuLoad, DynMenuAdd, DynMenuChange
(continued)