IN_AddExternalCommandEx

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

The IN_AddExternalCommandEx function adds a new, external command to the command table, and assigns its menu label, ToolTip, and Status Bar message.

Syntax

int IN_AddExternalCommandEx( commandID, szMenuLabel, szToolTip, szStatMsg )

Parameters

Meaning

SHORT commandID

identifier of the command to add. The ID number must be greater than or equal to 4096, but less than or equal to 7095, and must be unique for each command you add, or you receive an IN_ERR_CMD_ID_NOT_PERMITTED or IN_ERR_CMD_EXISTS error message.

CHARPTR szMenuLabel

text of the menu label

CHARPTR szToolTip

text for the ToolTip that corresponds to the new command

CHARPTR szStatMsg

text for the Status Bar message that corresponds to the new command

Remarks

Use IN_AddExternalCommand to add an external command to the command table without defining its menu label, ToolTip, or Status Bar text.

Release information

Added to Imagenation for Windows in Release 4.50.

Modified in Release 8.0 to support dockable toolbars.

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

See also

Defining external commands

Defining menu bars

Defining buttons and button bars