Checkbox

The Checkbox is a graphic element pre-defined to show a check mark. This graphic element appears selected or cleared based on the value of a boolean tag. It can be used as a control that toggles the value of a boolean tag between 1 and 0. The Checkbox graphic element appears in the
System
category of the
Toolbox
.
Use the Checkbox graphic element to:
  • Display the state of a boolean tag.
  • Toggle the state of a boolean tag.
    TIP:
    To use the Checkbox to toggle the state of a tag, on the
    Events
    tab, create a
    Button Behavior
     event. Set the button behavior to
    Toggle a tag on release
     and bind it to the same tag value in the
    ShowMark
     box of the
    Properties
    window. When you tap the checkbox on the HMI device, the button behavior event triggers, toggling the tag value in the
    ShowMark
    box to either select or clear the check box.
Built-in animation properties
Built-in animation properties appear under the
General
category of the
Properties
window. Specify values for these properties in order to animate the graphic element or change the information the graphic element shows on the HMI device.
Name
Category
Purpose
Accepted values
ShowMark
General
Specifies the selected or cleared state of the check box.
  • Show mark - selected
  • Do not show mark - cleared
Unique properties
Unique properties are properties that not all graphic elements in the
Toolbox
share.
Name
Category
Purpose
Accepted values
FillColor
Appearance
Specifies the fill color.
Any selected color in the
Color Picker
 or a Hex color value entered manually. The Hex value must be in the format #RRGGBB. R, G, and B are Hex digits from 0 through F and represent the color channel values for red, green, and blue. For example, #ffff00 produces yellow.
MarkColor
Appearance
Specifies the color of the checkmark.
Any selected color in the
Color Picker
 or a Hex color value entered manually. The Hex value must be in the format #RRGGBB. R, G, and B are Hex digits from 0 through F and represent the color channel values for red, green, and blue. For example, #ffff00 produces yellow.
UsePredefinedDisabled
Appearance
Specifies if a crosshatch overlay shows on the control element when you disable the element.
  • Use predefined disabled appearance
    (selected)
  • Do not use predefined disabled appearance
    (cleared)
Common properties
Common properties exist for all graphic elements.
Property
Category
Purpose
Accepted Values
Access
Security
Specifies if all users have access to the control element, or if access is inherited from the screen.
  • Inherit - Access inherited from screen.
  • Full Access - Access granted to all users.
Angle
Position and Size
Specifies the rotation angle.
Enter 180 to display the graphic element upside down. If you enter a value larger than 360, the portion of numeric value that is over 360 becomes the value. For example, enter 380 to see a value of 20. If you enter a value less than 0, the negative value is subtracted from 360. For example, enter -30 to see a value of 330.
  • Numbers 0 to 360
Enabled
Appearance
Specifies if the graphic element is available on the HMI device and if the graphic element accepts touch and key input.
  • Enabled - selected
  • Not Enabled - cleared
Height
Position and Size
Specifies the height in pixels.
Any positive numeric value
Opacity
Appearance
Specifies the transparency of the graphic element.
0 (fully transparent) - 100 (fully opaque)
Visible
Appearance
Specifies if the graphic element is visible on the HMI device.
  • Visible - selected
  • Not visible - cleared
Width
Position and Size
Specifies the width in pixels.
Any positive number
X
Position and Size
Specifies the horizontal coordinate, in pixels, from the upper left corner of screen to the upper left corner of a graphic element or group with no rotation. If the graphic element or group is rotated, the X property value does not change.
Any positive number
Y
Position and Size
Specifies the vertical coordinate, in pixels, from the upper left corner of screen to the upper left corner of a graphic element or group with no rotation. If the graphic element or group is rotated, the Y property value does not change.
Any positive number
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal