MSI Factory

The ListView control shows a single column of values with an icon next to each item. It enables the user to select a single string or integer value for a property.

Text

Text: (Note: Only used to set text style)

The font and font style to use for the ListView control text. Text styles can be managed in your project on the Styles dialog (Project > Styles). Example style:

{\UI_Font_Normal}

Property

Property name:

The name of the property to associate with this control whose value you want to set. If the Indirect checkbox is checked, this is the name of another property to set. Properties can be created and managed on the Properties tab of the Project Settings dialog (Project > Settings).

Indirect

If checked, the Property name is the name of another property, not directly associated with this control. If unchecked, the Property name is associated with this control.

Integer

If checked, the property associated with this control is interpreted as an integer value. If unchecked, the property value is a string.

ListView Items

The list of items to show in the ListView control. Click the Add button to open the Item Properties dialog where you can configure the item text, value, and icon resource of the new item. Existing items can be modified using the Edit button, removed using the remove button, and ordered using the up and down arrow buttons.

Size

The image size you want to use from the selected icon files. Choose from:

16x16

Loads the first 16x16 image from the icon files.

32x32

Loads the first 32x32 image from the icon files.

48x48

Loads the first 48x48 image from the icon files.

Options

Left scroll

If checked, the scroll bar will be shown on the left side of the control. If unchecked, it will be shown on the right side.

Sorted

If checked, the items will be listed in the order you configured in the ListView Items list above. If unchecked, the listview items will be sorted alphabetically.

Right aligned

If checked, the text in the control will be aligned to the right. If unchecked, it will be aligned to the left.

Fixed size

If checked, the icon image is cropped to fit the dimensions of the control. If unchecked the icon image is stretched to fit the control dimensions. The size of the control can be configured on the Attributes tab.

RTL reading order

If checked, the text in the control will be shown in right-to-left reading order. If unchecked, it will be shown in left-to-right reading order.

More Information

MSDN Online: ListView Control

MSDN Online: Controls

MSDN Online: Control Table

WiX Help File: Control Element

WiX Help File: ListView Element

Learn More: Indigo Rose Software - MSI Factory - Buy Now - Contact Us