Modifying Custom Commands

Once you have created a custom command, you can modify it in the following ways:

Edit the command definition, for example, to change the default values for arguments.
Edit the script that implements the command to change its behavior.
Remove the command.

You can modify only the custom commands stored in your user location. You cannot modify commands stored in the workgroup or factory locations. In addition, you cannot modify self-installing custom commands or commands contained in add-ons.

Editing Command Definitions

Editing the command definition changes a command's properties, such as its description, tooltip, or the default values for arguments. Note that you cannot use this method to modify the properties of self-installing commands — you must modify the associated script instead.

Open the Command Editor by doing one of the following:
- Right-click on a button in a toolbar and choose Edit Command.
  
  or
- On the Tree tab of the Plug-in Manager, right-click on the command and choose Properties.
In the Command Editor, modify the options as desired. For a description of the available options, see Command Editor [Properties Reference].

Editing Script Implementations

You can modify what a command does by modifying the script that implements the command.

Open the script file in any text editor.
- If there is a button for the command on a toolbar, you can do this by right-clicking on the button and choosing Edit Script.
- Alternatively, you can locate the command on the Plug-ins or Items tabs of the Plug-in Manager, then right-click on it and choose Edit.
Make any desired changes and save the script file.

The modified script is run the next time that the command is called.

NoteIf you changed the definition of a function by adding or removing arguments, you should edit the command definition to reflect the changes. Alternatively, you can remove the command and create it again.

Removing Custom Commands

When you remove a non–self-installing command, it is "deregistered". It is no longer available for use on buttons or inside scripts, and existing scripts that make use of it will fail. The script or library file that implements the command is not deleted from the file system.

After you have removed a custom command, buttons that called it will display "Command Unavailable". You can remove these buttons as described in Organizing Toolbars with Toolbar Widgets.

To remove a command directly from a toolbar

Right-click on the button and choose Remove Command.

Both the command and the button are removed.

To remove a command using the Customize Toolbar dialog box

You can use the Customize Toolbar dialog box to remove a command whether or not the command has an associated button.

Display the Customize Toolbar dialog box by doing one of the following:
- Right-click on an empty portion of any custom toolbar and choose Customize.
  
  or
- Choose View Custom Toolbar Customize from the main menu.
Under Command Categories, select Custom.
Under Available Commands, select the command you want to remove.
Click Remove Command.