All Editions
Related Functions
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) IN_BUTTONBAR_VIEW (5) IN_BUTTONBAR_WINDOWS (6) IN_BUTTONBAR_BATCH (7) IN_BUTTONBAR_STANDARD (8) | |
|
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) | |
|
SHORT relCmdID |
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