CreateToolbarControl

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 String Unique identifier of the toolbar to which the button is added.

Type siToolbarControl Type of control

Name String Display name for control

InsertAt Integer Insert position into toolbar, -1 means add at end.
Default Value: -1 add at end

Examples

Parameter	Type	Description
Toolbar	String	Unique identifier of the toolbar to which the button is added.
Type	siToolbarControl	Type of control
Name	String	Display name for control
InsertAt	Integer	Insert position into toolbar, -1 means add at end. Default Value: -1 add at end

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 );