Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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. |