Syntax
| Command | Description | Return Value |
|---|---|---|
Control <number> [<range...>] |
Select one or more Shared Controls | The pressed state of the selected control(s) |
Control Clear or Control ; |
Deselect all Shared Controls | 0 |
Control ? |
Return the current selection | A selection string |
Abbreviation
K
Description
Selecting Shared Controls
The Control command selects one or more Shared Controls in the system. Shared Controls are generic triggers that operate like buttons or contacts and can be linked to physical buttons or contacts. Shared Controls are useful for creating behavior and/or logic in a single place and then having multiple physical buttons or contacts “point” to the Shared Control.
Use the Control command in conjunction with an action command like At, On, Off, Set, Enable or Disable to change the properties of one or more Shared Controls. When used alone or in logic expressions, the Control command returns the current state of the specified control(s).
Either a single Shared Control number can be specified, or a range of controls can be specified using the various selection operators like +, -, > and ~.
The wildcard character * can be used as the control number to mean all controls.
Deselecting All Controls
Using either Control Clear or Control ; will deselect all shared control while leaving “Control” as the current command target.
Determining Which Shared Controls Are Selected
The question mark ? can be used to ask what the current selection is. A selection string will be returned, which will consist of a single number (like 3) or a range (like 5>7+9), or if no controls are selected, 0 will be returned.
Examples
Control 1
Selects Shared Control 1. Future action commands will be directed towards control 1. Also returns0, or1to indicate if the control is currently unpressed or pressed.
Control 1>5 On
Turns the LED indicators of Shared Controls 1 thru 5 on.
Control 1>3+5>8 Off
Turns the LED indicators of Shared Controls 1 through 3 and 5 through 8 off.
Control 3>5 Enable
Enables Shared Controls 3 through 5.
Control 1
Set Button.OnColor {100,50,0}
Set Button.Flash 4
On
Disable
Selects Shared Control 1, then sets the button’s OnColor property to Orange (RGB color (100,50,0)), then sets the button’s Flash property to 4, then turns the LED indicator on, then disables button presses from the button.
Control ?
Returns the current Shared Control selection in the format of a single number like3, or a range like5>7+9.