## CreateToolbarButton

### Description

Creates a new button on a toolbar. You can change the format of your toolbar by adding line separators, line breaks, etc. using the CreateToolbarControl command.

### Scripting Syntax

    CreateToolbarButton( Toolbar, Command, [Index] );

### Parameters

Parameter | Type | Description
--- | --- | ---
Toolbar | String | Unique identifier of the toolbar to which the button is added.
Command | String | Unique identifier of the command linked to the new button. You can determine the unique identifier for a command by calling Command.UID.
Index | Integer | Position of the button on the toolbar (0 is the first button, 1 is the second button, and so on; -1 is the last button). Default Value: -1 (add to end)

### Examples

#### VBScript Example

    sub Install()

    	dim file, toolbar, command, path

    	path = Application.InstallationPath( siUserPath )

    	file = path & "\Data\Scripts\myUtils.vbs"

    	'Create Toolbar

    	toolbar = CreateToolbar("Utilities")

    	'Create Commands

    	command = CreateScriptCommand( "Simplify It" ,_

    					"makeSimple" ,_

    					file ,_

    					"MakeSimple",_

    					"Makes life easier." )

    	'Add button to toolbar.

    	CreateToolbarButton toolbar, command

    end sub

### See Also

CreateToolbar CreateToolbarControl CreateScriptCommand Command.UID