Action Arguments - AMX i!-ConnectLinx Instruction Manual

Using i!-ConnectLinx

Action Arguments

i!-ConnectLinx supports action arguments to supply additional information with each action. For
instance, if you wanted to support an action to set the program volume, the user needs to supply a
volume level. This is accomplished using arguments.
Each action can support zero or more arguments. Each argument can be one of the following types:
Each argument is numbered in the order they are added. Arguments are added by using the 'ADD
NARG', 'ADD LARG', '
When an i!-ConnectLinx compatible technology requests an action with arguments to be executed,
the argument values are passed to i!-ConnectLinx. i!-ConnectLinx then posts the argument values
as levels for number and level arguments and strings for string and enumeration arguments. These
values can be retrieved by using
saved. Then, when an action request is triggered via a BUTTON_EVENT, you can retrieve these
argument values and use them (as appropriate) for the action to be executed.
Each argument is provided an ID at the time it is added. The ID's start at one and are numbered
sequentially to each argument as they are added. When i!-ConnectLinx posts the argument value, it
supplies the ID number as well. For numbers and levels, this ID is the level number to which the
argument is posted. For strings and enumerations, this ID is included in the string that posts the
argument value.
For an example, see the i!-ConnectLinxStandardFunctionShell.axi file.
6
Number – A single number from –32767 to 32767. You can define the minimum value,
maximum value, desired step and a default value. The user is presented with a text box in
which to enter this number.
Level – Similar to a Number argument, only the user is presented with a slider to enter
the level.
String – A string. You can define the minimum length, maximum length and default
value. The user is presented with a text box to enter this string.
Enumeration – A list or enumeration of values the user can choose from. The user is
presented with a drop down list to choose and value from.
' and '
ADD SARG
LEVEL_EVENT
' commands.
ADD EARG
s and
DATA_EVENT
s in your program and must be
i!-ConnectLinx