ListView Table

[This is preliminary documentation and subject to change.]

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

The ListView table has the following columns.

Column Type Key Nullable
Property Identifier Y N
Order Integer Y N
Value Formatted N
Text Formatted Y
Binary_ Identifier 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 listview.
Order
A positive integer used to determine the ordering of the items that appear in a single listview list. The integers do not have to be consecutive. If a listview is defined as ordered, all the items should have an Ordering value. If the listview 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.
Binary_
The image data for the icon. This is a foreign key to the Binary table.

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.