CreateToolbarButton

Categories

customization

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