CreateToolbarControl

Categories

customization

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

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

CreateToolbar CreateToolbarButton CreateScriptCommand