ScriptCommand
最后更新于
最后更新于
In a script's method it can call the .AddCommand method to to the Opus internal command set. Each call to AddCommand returns a ScriptCommand object that the script needs to initialize.
desc
string
Use this to set a description for the command, that is displayed in the dialog when the user selects the command from the .
fayt
object:
Returns a object that you can use to initialise this command to .
hide
bool
Set to True to hide this command from the drop-down command list shown in the . This lets you add commands that can still be used in buttons and hotkeys but won't clutter up the command list.
icon
string
Use this property to assign a default icon to this command. You can specify the name of an internal icon (if you want to specify an icon from a particular set, use setname:iconname - use this if you have bundled your script in a with its own icon set) or the path of an external icon or image file.
label
string
Use this to set a label for the command. This is displayed in the of the dialog (under the Script Commands category), and will form the default label of the button created if the user drags that command out to a toolbar.
The actual name of the command (used to invoke the command) is assigned through the name property.
method
string
This is the name of the method that Opus will call in your script when the command is invoked. This would typically be set to OnXXXXX where XXXXX is the name of the command, however any method name can be used.
When the method is invoked it is passed a single argument, a object. Generically this method is referred to as .
name
string
This is the name of the command. This determines the name that will invoke the command when it is used in buttons and hotkeys.
noprogress
bool
Set to false if you don't want your command to display a progress indicator if more than one file is selected.
template
string
This lets you specify an optional command line template for the command. This is a string in the form ARGNAME1/MOD,ARGNAME2/MOD,ARGNAME3/MOD, etc, where ARGNAME is the name of the argument and /MOD are one or more . The command line template can specify as many arguments as needed.
When your command is invoked and its ****event is triggered, any arguments supplied on the command line are parsed according to this template and provided via the ..args property.