Menuaddicon - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Menus

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
ParentId — ID of parent if adding a child entry (0 if adding top-level
Icon
Id
NOTE: If you are adding to a menu created with the resource compiler (using
Flags
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.
TI-89 / TI-92 Plus Developer Guide
— Handle to a dynamic menu created with MenuNew or
MenuLoad.
entry).
— Pointer to ICON.
— ID of new entry. If Id is 0 then use sequentially numbered
Ids. IDs are limited to the range 0x0001 . . . 0xFFF (12 bits).
MenuLoad) do NOT use the range F00 . . . FFF.
— Must be one of the following:
DMF_TOP
DMF_TOP_SUB
DMF_CHILD
DMF_CILD_SUB — Child of parent ( ParentId ) that can
Not for Distribution
— New top-level entry that cannot be a
parent.
— New top-level entry that can have
children.
— Child of parent (as specified by
ParentId ).
also have children.
Beta Version January 26, 2001
875