Controls (Windows Installer)

Developers of installation packages can author a user interface containing the controls discussed in this topic. For information on how to add a particular control to a dialog box, see the topic for that control and read the section Adding Controls and Text.

Some controls, such as CheckBox and ComboBox, are associated with a property specified in the Property column of the Control table. A user changes the value of this property by interacting with the control. Passive controls, such as Billboard and bitmap, are not associated with such a property.

For security, private properties cannot be changed by a user interacting with the user interface. For a property to be set by the user interface, it needs to be a public property and in uppercase. See also About Properties.

In some cases a control may be redrawn incorrectly when canceling out of a dialog. This has to do with the order in which the controls receive WM_PAINT messages after the Cancel dialog is removed. To fix this, try changing the order of the controls in the Control table.

Control name Associated property Brief description of control
Billboard No Displays billboards based on progress messages.
Bitmap No Displays a static picture of a bitmap.
CheckBox Yes A two-state check box.
ComboBox Yes A drop-down list with an edit field.
DirectoryCombo Yes Select all except the last segment of the path.
DirectoryList Yes Displays folders below the main part of path.
Edit Yes A regular edit field for any string or integer.
GroupBox No Displays a rectangle that groups other controls together.
Hyperlink No Displays a HTML link to an address, which opens in the default browser.Windows Installer 4.5 and earlier: Not supported.
Icon No Displays a static picture of an icon.
Line No Displays a horizontal line.
ListBox Yes A drop-down list without an edit field.
ListView Yes Displays a column of values with icons for selection.
MaskedEdit Yes An edit field with a mask in the text field.
PathEdit Yes Displays folder name or entire path in an edit field.
ProgressBar control No Bar graph that changes length as it receives progress messages.
PushButton No Displays a basic push button.
RadioButtonGroup Yes A group of radio buttons.
ScrollableText No Displays a long string of text.
SelectionTree Yes Displays information from the Feature table and enables the user to change their selection state.
Text No Displays static text.
VolumeCostList No Displays costing information on different volumes.
VolumeSelectCombo Yes Selects volume from an alphabetical list.