List box

Storage size

2 bytes

Keyable length

Not applicable

Static values

Text for items in the list

Function

Allows only one item to be selected in the list box. The items in the list are specified by the data type definition or at runtime, using the add item statement. Items added at runtime aren’t saved in the application dictionary; they must be added each time the application is run.

The value of the field is an integer corresponding to the position of the selected item as it appears in the Static Text Values window. Items are numbered sequentially so that the first item in the list is 1, the second is 2, and so on. If the static text items are sorted for display, the value of the field is still based upon the selected item’s position in the Static Text Values window, not its position as displayed in the list box at runtime. Up to 32,767 items can be displayed in the list.

The change script for a list box runs each time a new value is selected in the list, including each time the up or down arrow key is pressed to move to a different value.


Documentation Feedback