List Box Selector

The List Box Selector is a read-write graphic element with built-in animation properties to write a list item to the controller. This graphic element appears in the
System
category of the
Toolbox
.
Use the List Box Selector graphic element to create a list of items to select on the HMI device. The List Box Selector writes the different value to the tag as items are selected on the HMI device. Items in the list must have unique names. If an item does not have a unique name, select an item that has a duplicate name.
Have the List Box Selector write different values to the tag in the controller. These are the common tag types in the Logix controller for binding the
Value
property of the List Box Selector:
  • 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 selecting the Part Entering row in the List Box Selector on the HMI device, write the value Part Entering to the tag in the controller.
  • Numeric tag.
     Separate the strings in the
    Item
    box and the numeric value 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 selecting the Machining Part row in the List Box Selector on the HMI device, write the the value 4 to the tag in the controller.
    Tip:
    The List Box Selector does not support Boolean expressions.
IMPORTANT:
Do not rotate the List Box Selector graphic element. Rotating the List Box Selector graphic element prevents touch input selection of the items on the HMI device.
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 send numbers to 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 Selector will write a value of 10, 30, or 50 to the Value property when the corresponding Item is selected at runtime.
  • Parenthesis displayed on Items when the Item is enclosed in quotation marks – selected
  • Parenthesis in Items always interpreted as containing a number to write to 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
CaretColor
Appearance
Specifies the color of the selection caret.
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.
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
ScrollBarFillColor
Appearance
Specifies the color of the scroll bar.
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.
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.
Normal