ListBox Table

[This is preliminary documentation and subject to change.]

The lines of a listbox are not treated as individual controls, but they are part of a listbox that functions as a control. The ListBox table defines the values for all listboxes.

The ListBox table has the following columns.

Column Type Key Nullable
Property Identifier Y N
Order Integer Y N
Value Formatted N
Text Formatted Y

Columns

Property
A named property to be tied to this item. All the items tied to the same property become part of the same listbox.
Order
A positive integer used to determine the ordering of the items that appear in a single listbox. If the listbox is defined as ordered, all items should have an Order value. The integers do not have to be consecutive. If the listbox is defined as unordered, this column is ignored.

Positive numbers only.

Value
The value string associated with this item. Selecting the line sets the associated property to this value.
Text
The visible text to be assigned to the item. If this entry or the entire column is missing, the text defaults to the corresponding entry in Value.

Remarks

Formatting

The contents of the Value and Text fields are formatted by the MsiFormatRecord function when the control is created, so they can contain any expression that the MsiFormatRecord function can interpret. The formatting occurs only when the control is created, and it is not updated if a property involved in the expression is modified during the life of the control.