The ValueList control provides a list style selector of named values. It is useful for selecting flag values. The selected value can be set by the user or by a connected device. The ValueList control can send a message to a connected device whenever the selection changes. Its run-time properties can be referenced in command messages.

Use the collection editor on the NamedValues property to set the values in the list. Each value is an unsigned, 32-bit number.

Value list collection editor

Edit the values in the list using the NamedValues collection editor

Design-time Properties for the ValueList control
Property Description
NamedValues The collection of named values that the user can select from
DefaultSelection Index of the item that should be selected initially
SelectionMode Controls whether the user can select 1, many or no items from the list.
IntegralHeight When true, the value list height is adjusted so only complete items are shown in the list
HorizontalScrollBar A horizontal scrollbar is shown when true so the user can scroll to see items wider than the list
ScrollAlwaysVisible When true, scroll bars are always shown regardless of the number of items in the list
Run-time properties for the ValueList control
Name Access Type Description
Name Read only string The name of the control
SelectedIndex Read/write int The row number of the selected item (starting from 0). Only supported when SelectionMode is One
SelectedName Read/write int The name of the selected item. Only supported when SelectionMode is One
Value Read/write UInt32 The selected value. If multiple values are selected, calculates a bit-wise or for all selected items

This control also supports all the common run-time properties.

Start typing and press Enter to search