Description
Creates a new control on a toolbar. Toolbar Controls allow you to tweak the layout of your toolbar by adding space and line separators, forcing line breaks, group headers and cascading menus. See siToolbarControl for a complete list of options.
Scripting Syntax
CreateToolbarControl( Toolbar, Type, Name, [InsertAt] )
Parameters
|
Parameter |
Type |
Description |
|
Toolbar |
Unique identifier of the toolbar to which the button is added. |
|
|
Type |
Type of control |
|
|
Name |
Display name for control |
|
|
InsertAt |
Insert position into toolbar, -1 means add at end. Default Value: -1 add at end |
Examples
JScript Example
// Create Toolbar with controls
var uidToolbar = CreateToolbar("My Toolbar");
var uidCmd = commands("Info Scene").uid;
CreateToolbarButton( uidToolbar, uidCmd );
CreateToolbarControl( uidToolbar, siTBCtrlLineSeparator, "line separator" );
CreateToolbarButton( uidToolbar, uidCmd );
CreateToolbarControl( uidToolbar, siTBCtrlMenu, "menu button" );
CreateToolbarButton( uidToolbar, uidCmd );
CreateToolbarControl( uidToolbar, siTBCtrlLineBreak, "line break" );
CreateToolbarButton( uidToolbar, uidCmd );
CreateToolbarControl( uidToolbar, siTBCtrlGroupHeader, "group header" );
CreateToolbarButton( uidToolbar, uidCmd );
CreateToolbarControl( uidToolbar, siTBCtrlBlankSeparator, "blank separator" );
CreateToolbarButton( uidToolbar, uidCmd );
See Also
SOFTIMAGE|XSI v6.01