runTimeCommand

Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

runTimeCommand [-annotation string] [-category string] [-categoryArray] [-command script] [-commandArray] [-commandLanguage string] [-default boolean] [-defaultCommandArray] [-delete] [-exists] [-numberOfCommands] [-numberOfDefaultCommands] [-numberOfUserCommands] [-save] [-userCommandArray] name

runTimeCommand is undoable, queryable, and editable.

Note that the resulting command takes no arguments, has no flags and may not be queried or edited.

The command name you provide must be unique. The name itself must begin with an alphabetic character or underscore followed by alphanumeric characters or underscores.

If you create your run time commands in a script which is automatically sourced at startup then set the default flag to true. This will prevent the application from attempting to save these commands.

Return value

In query mode, return type is based on queried flag.

Flags

Long name (short name)	Argument types	Properties
-exists(-ex)
Returns true|false depending upon whether the specified object exists. Other flags are ignored.
-command(-c)	script
Command to be executed when runTimeCommand is invoked.
-commandLanguage(-cl)	string
In edit or create mode, this flag allows the caller to choose a scripting language for a command passed to the "-command" flag. If this flag is not specified, then the callback will be assumed to be in the language from which the runTimeCommand command was called. In query mode, the language for this runTimeCommand is returned. The possible values are "mel" or "python".
-annotation(-ann)	string
Description of the command.
-category(-cat)	string
Category for the command.
-categoryArray(-caa)
Return all the run time command categories.
-default(-d)	boolean
Indicate that this run time command is a default command. Default run time commands will not be saved to preferences.
-numberOfCommands(-nc)
Return the number of run time commands.
-numberOfDefaultCommands(-ndc)
Return the number of default run time commands.
-numberOfUserCommands(-nuc)
Return the number of user run time commands.
-commandArray(-ca)
Returns an string array containing the names of all the run time commands.
-defaultCommandArray(-dca)
Returns an string array containing the names of all the default run time commands.
-userCommandArray(-uca)
Returns an string array containing the names of all the user run time commands.
-save(-s)
Save all the user run time commands.
-delete(-del)
Delete the specified user run time command.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

//    Create a command that simply prints a message.  After executing
//    the following lines enter the command name <i>MyHelloCommand</i>
//    in the Command Line.
//
if (!`runTimeCommand -exists MyHelloCommand`) {
    runTimeCommand
        -annotation "Print the word \"Hello\""
        -command ("print \"Hello\\n\"")
        MyHelloCommand;
}

//    Create a window with a button that invokes the <i>MyHelloCommand</i>
//    command.
//
window;
paneLayout;
button -command ("MyHelloCommand");
showWindow;