Appendix A: System Routines — Menus
875
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
MenuAddIcon
Declaration:
HANDLE
MenuAddIcon
(HANDLE
hMenu
, SWORD
ParentId
,
const WORD *
Icon
, short
Id
, WORD
Flags
);
Category(ies):
Menus
Description:
Add an icon to a dynamic menu.
Icon
points to an array of 16 words that
defines a 16x16 icon.
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).
Icon
— 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.
Note that if there is not enough memory to add the new entry, the
MF_ERROR bit in
MenuFlags
(
hMenu
) is set.
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
Example:
See
MenuAddText
.
To Next Page
Loading...
