To properly display this page you need a browser with JavaScript support.
A Command is a user-defined
Event that will encapsulate a code (Callback).
Using commands is a simple and efficient way to create a user specific menu with all commands listed.
For now, there is no way to show/hide a command nor to display them hierarchically. This feature might come in next versions.
Name
Name of the Command (and name of the associated Event).
To add a separator in the generated menus (or submenu), just enter - (minus sign)
Group
In order to group similar commands into the same submenu, use this field to create a submenu in the runtime command menu (see image below).
Separators can be added using the - name with the specified group.
For the moment, multiple submenus are not possible, only one level.
Names must be unique, even if belonging to different groups.
Input
Specify here if a selected (object) must be attached to the command:
Mouse position : only the coordinate will be attached;
Mouse selection : only the selected object will be attached (if any).
Parameter
Specify if parameter(s) must be used after the command is called from the menu.
Static : use only the parameter line in the Value field below;
Request : use the Default parameter line and tell the user to validate or change it.
Value/Default
Enter in this field the parameter(s) of the command. Use commas to separate values of a list.
If Request is selected, the optional Default line is used as a first suggestion to the user.
Description
If Request is selected, the Description line will be use to explain the kind of parameters to enter in the data line:
For ie, putting in the Default field: "0,0,0" and in the Description field: "Enter position x,y,z separated with commas" will give that window:
Availability
The Commands defined in the scenario can be triggered from the code (by raising the corresponding event) but most of the time, the purpose of defining a Command is to let the user select it from the GUI. vsTASKER offers two ways for using these commands:
Scenario menu : At runtime (only), right clicking on the scenario map will display the
Commands menu with all defined commands listed in the same order as in the
Defined list.
Hook window :
Not available yet.
Update/Create
Whenever an Edit field has been changed, use this button to create the command or update the selected command on the Defined list.
Failure to use this button will not create nor update the command.
List
This lists all defined commands.
Left of the column sign is the name of the associated event (spaces are replaced with underscore _)
Right summarize the input and parameter settings.
Use the check mark for deletion.
Sorting
Use this button to sort alphabetically the list of commands.
Rearrange
Move up or down in the list the selected command.
Delete
Use this button to delete all marked commands (or the selected one if none).