You are here: Reference for User Interface Elements > Processing Workspace Interface and Dialog Boxes > Links Dialogs > Toggle Link

User Interface Reference

Toggle Link Dialog Box

How to Access

There are several ways to access the Toggle Link dialog box:

  • From the Toggle control On a Toggle control that is participating in a link, click its link icon. If it is participating in multiple links, the Link References dialog box opens, displaying all the links in which the control is participating. Click one of the links to open its Toggle Link properties dialog box. If the control is participating in only one link, the Toggle Link properties dialog box displays automatically.
  • From the All Links dialog box On the Processing Toolbar, click Linking to open the All Links dialog box. Click the Toggle tab, and then click one of the links in the list to open its Toggle Link properties dialog box.
Purpose

Displays the properties of the Toggle control link. From this dialog box, you can:

  • rename the link
  • manually activate or deactivate the link
  • change the Toggle value (on or off)
  • view the list of participants in the link, as well as which participants are active in the link
  • access the individual controls' properties dialog boxes
  • view and/or change the Link Master
  • invert how the individual controls behave when the link is toggled on and off
  • add controls to the link
  • delete one or more link participants
User Interface Elements

Toggle Link Properties

UI Element Purpose
Link Name Displays the link name and allows you to edit the name
Active checkbox

Displays the link state. Select to activate the link, deselect to deactivate the link.

Toggle Value checkbox

Displays the current value (or state) of the Toggle, and allows you to change it. Select the checkbox to turn the Toggle on. Deselect the checkbox to turn the Toggle off.

note: If the link includes a read-only control, you cannot change the Toggle Value from within this dialog box. You can only change it from the read-only device or from the dialog box for the read-only control in the Hardware Controls tab. See Testing a Control Link.

Master

Designates which control serves as the control Link Master. To designate another control as the Link Master, select its radio button.

note: If the link includes a read-only control, you cannot change the Link Master designation, which is always the read-only control.

Participant (Parent-Control) Displays the controls that are participating in the link, providing the name of the device or block as well as the actual control. Click a participant's name to open its properties dialog box.
Inverted checkbox Select this checkbox to invert, or reverse, the behavior of the control. For example, let's assume we have a link between a Mute control and a DR2 Toggle control. Inverting the Mute control causes it to unmute when the Toggle is on. Inverting the DR2 Toggle control causes it to work in reverse to the other controls (as long as they are not also inverted). In other words, if the Mute control and the link's Toggle control are on, the DR2's Toggle control is off. Thus, from the perspective of the DR2 Toggle control, you would turn it off to activate the Mute control.
Link icon Indicates the state of the control in this link. Bright purple indicates the control is active in this link. White indicates the control is not active in this link. A control can be active in only one link at a time. It is always active in the active link that is highest in the control link priority list.
Purple box at bottom Provides a location for adding new Toggle controls to the link. To add a new Toggle control, drag and drop its link icon onto this purple box.
Delete icon (X) Removes the selected control from the link. (To select a control, click anywhere on it—except on its hyperlink name or on its Master radio button.)