IN_AddButton

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

The IN_AddButton function adds a separator or the given command button to the specified toolbar. To see the changes, use IN_RebuildButtonBar.

Syntax

int IN_AddButton ( buttonBar, newCmdID, relCmdID, relPosition )

Parameters

Values

Meaning

SHORT buttonBar

IN_BUTTONBAR_RIBBON (1) Obsolete. Do not use this value in new integrations.

IN_BUTTONBAR_TOOL (2) add the command to the Tool Bar

IN_BUTTONBAR_3D (3) add the command to the 3D toolbar

IN_BUTTONBAR_PAGE_NAVIGATION (4)
add the command to the Page Navigation toolbar

IN_BUTTONBAR_VIEW (5)
add the command to the View toolbar

IN_BUTTONBAR_WINDOWS (6)
add the command to the Windows toolbar

IN_BUTTONBAR_BATCH (7)
add the command to the Batch toolbar

IN_BUTTONBAR_STANDARD (8)
add the command to the Standard toolbar

SHORT newCmdID

Command IDs identifier of the new command button to place in the toolbar. Make sure the button is registered and has the bitmap set for it.

IN_BUTTONBAR_SEPARATOR (1)
adds a separator to a toolbar. See Remarks.

SHORT relCmdID

Command IDs

identifier of the command button to place the new command relative to. If relPosition is set to first or last, then this can be ignored.

SHORT relPosition

Determines where to place the new command:

IN_BUTTON_PSN_FIRST (1) put button first on the toolbar

IN_BUTTON_PSN_LAST (2) put button last on the toolbar

IN_BUTTON_PSN_PREV (3) put button in front of the given command

IN_BUTTON_PSN_NEXT (4) put button after the given command

Remarks

Only buttons related to the commands available in your edition of Imagenation, or external commands, can be added.

We recommend you do not add multiple separators using the same button as a reference.

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

Adding and removing buttons

Defining buttons and button bars