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