List Box Indicator

List Box Indicator

The List Box Indicator graphic element is a read-only list box with built-in animation properties to highlight an item in the list. This graphic element appears in the
System
category of the
Toolbox
.
Use the List Box Indicator graphic element to create a list of items highlighted by the system. The List Box Indicator highlights the item in the list that matches the value of the tag in a controller. For example, the list could highlight the bottling line that is filled. The item must exist in the list in order for the List Box Indicator to highlight the item. Items in the list must have unique names. If an item does not have a unique name, the system highlights any one of the items that has a duplicate name.
Have the List Box Indicator highlight different text based on different values in the controller. There are two common tag types in a Logix controller to bind to the
Value
property of the List Box Indicator:
  • String tag.
    Separate the strings in the
    Items
    box using commas. For example, in the
    Items
    box enter: No Part,Part Entering,Part In Place,Machining Part,Part Exiting. Do not enter spaces between the commas and the items. Bind the
    Value
    box in the
    Properties
    window to the tag containing the items. When the string tag bound to the
    Value
    box has the Part Entering value, the List Box Indicator highlights the Part Entering row.
  • Numeric tag.
    Separate the strings in the
    Item
    box and the numeric value you want to associate with each string in parentheses. Separate those items using commas. Do not enter spaces between the commas and the items. For example, in the
    Items
    box, enter: No Part (1),Part Entering (2),Part in Place (3),Machining Part (4),Part Exiting (5). Bind the
    Value
    box in the
    Properties
    window to the numeric tag. For example, bind to the DINT tag containing the items. When the DINT tag bound to the
    Value
    box has a value of 4, the List Box Indicator highlights the Machining Part row.
    Tip:
    The List Box Indicator does not support Boolean expressions.
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
DisplaySpecialCharacters
General
Select to display parentheses in Items when the text in the Item is enclosed in quotation marks. For example, “Low Speed (10 RPM)”
Note: You can still read numbers from the Value property by using numbers in parentheses after the Item in quotation marks. For example, if you use the following for the Items property: "Low Speed (10 RPM)"(10),"Medium Speed (30 RPM)"(30),"High Speed (50 RPM)"(50), the List Box Indicator will indicate Low Speed (10 RPM) when the Value property is 10.
  • Parenthesis displayed on Items when the Item is enclosed in quotation marks – selected
  • Parentheses in Items always interpreted as containing a number matching a value in the Value property - cleared
Items
General
Specifies the items for the list, separated by commas.
One or more alphanumeric strings separated by commas
Value
General
Specifies the value of the graphic element.
Bound tag
Unique properties
Unique properties are properties that not all graphic elements in the
Toolbox
share.
Name
Category
Purpose
Accepted values
FontName
Appearance
Specifies the font of the text.
Any selected font
FontColor
Appearance
Specifies the color of the text.
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.
FontSize
Appearance
Specifies the size of the text.
Positive numbers
Bold
Appearance
Makes the text or value on the graphic element bold.
  • Bold - selected
  • Not bold - cleared
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.
ItemPadding
Appearance
Specifies the amount of space before list items.
Numeric values
SelectionColor
Appearance
Specifies the color of the selected list item.
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.