* Can use properties from a Style Settings tag.
See also: Toggle Switch Widget
The Illuminated Toggle Switch widget is a control method used to output either of two possible values. When used with a digital I/O tag, the switch will send a 1 for on and a zero for off. When used with a Selector switch, the values will be those configured for the first two of the three possible positions of the selector switch.
To indicate to the operator that the image is a button, a highlight is drawn when the pointer is over the switch.
In the event that the position feedback from the Selector Switch indicates that the actual position is not the same as the requested position, the border of the image will blink using the mismatch color. You should select a color that stands out clearly on your page background, but red is not advised because it is commonly understood to mean that an alarm has been triggered.
The switch works by toggling between positions 0 and 1 whenever the operator clicks on the button. Should the tag be in an invalid state (which will not be unusual when a selector switch is first created) then it is not clear whether the first click should move the switch to the state 0 or the state 1 position. For this reason, a dialog will prompt the operator for an initial position.
The Properties dialog for an Illuminated Toggle.
Style
Optionally, select a Style Settings tag to control the colors shown by the light, in response to the linked tag's value and alarm state.
See:Style Settings Tags
Off Light Image / Off Image
The image used for each position is composed of two parts: a basic light and a frame with semi-opaque lens that provides shape to that light.
Within the Bitmaps\Selector Switches\ folder of the Images palette, lights and lens images that are designed to work together will have matching names.
Image Select
Opens the Select Image dialog, within which you can browse for images, import new images, and select the image to use.
* VTScada recognizes the following image formats: .BMP, .CUT, .PCX, .EMF, .WMF, .JPG, .PNG, .TIF
Image Adjust
Opens the Adjust Image dialog box, which can be used to change the color and other display characteristics of the image. See: Adjust Image Dialog
Image Clear
Remove the selected image and do not select a replacement.
On Light Image / On Image
Similar to the Off Light Image and Off Image. Selects the light and lens images to display when the toggle is in position one.
Mouse Over
The Mouse Over image to be used when the toggle is in position one. When left blank, the Illuminated Toggle will be highlighted when the operator moves the pointer over it.
Disabled
You may choose an alternate image to use when the operator does not have security privileges to use this tag.
Confirmation Dialog
When selected, operators must confirm that they intended to toggle this control.
Draw light over image
Reverses the order of the light and the lens. Typically, the lens will contain the On/Off label, therefore choosing this option will hide the label and accentuate the color.
Disable Options
Disable selected operator-interaction features of this widget.
See: Operator Interaction Controls
Buttons & Switches\
