IN_GetMenuDefinition

All Editions $image\bltlrgsq_shg.gif$ Related Functions $image\bltlrgsq_shg.gif$ Example

The IN_GetMenuDefinition function returns a list of the command identifiers for the commands in the specified menus.

Syntax

int IN_GetMenuDefinition ( menuID, maxSize, pCmdList )

Parameters	Values	Meaning
SHORT menuID	IN_MENU_MAIN (1) main Imagenation menu IN_MENU_LAYERS_WINDOW (2) Layers window menu IN_MENU_DETAIL_WINDOW (3) Detail window menu IN_MENU_SYMBOL_PALETTE (4) Symbols palette menu
SHORT maxSize	the maximum size of the pCmdList array in bytes
Output Parameters	Values	Meaning
CHARPTR pCmdList	pointer to: the number of commands in the list, followed by: Command IDs pointer to the list of commands in the selected menu. For example: 100,100.101,100.102, 100.102.103,100.104. See Remarks. IN_MENUITEM_SEPARATOR (1) separator IN_MENUITEM_WINDOW_LIST (2) position of the list of open windows IN_MENUITEM_MRU_LIST (3) position of the most recently used list

Remarks

In the reply, commas are used to separate entries. Periods are used to denote the level of the entry. For example, the File menu is on the first level and has an identifier of 100. The File, Open command is on the second level, and its identifier is 100.101.

Only floating windows available in your edition of Imagenation can be queried.

Release information

Added to Imagenation for Windows in Release 4.50.

As of Release 5.1, also available in Imagenation for UNIX.

See also

Changing menu contents

Defining menu bars