Static Text

Displays static text.

Edit Box

Regular edit field for string or integer. If you use the Password flag you will create an edit control for entering passwords. If the "Default Value" field is empty, the default edit control's value will be set to the value of the property defined in the "Property Name" field.

Push Button

Displays a basic push button. For a push button you can set the "Elevation Shield" flag which will add the UAC icon on the button on Windows Vista or above. This is recommended for buttons that trigger actions which need administrative privileges (for example the "Install" button).

Command Link Button

Command links have a clean, transparent appearance making them suitable in many situations. These buttons can be used when you have to provide a long explanatory description about the action it does. You can read more about this control in Enhanced User Interface page.

Check Box

A two-state check box. The check box is used to establish one of two possible states (checked and unchecked). The check box's property will be empty until the check box is checked (the property's value is set to the value specified in the "Value" field). If you specify a value in the "Default Value" field then the check box will be checked by default.

For a check box control you can set the "Push Like" flag which will transform it into a button with two states: pressed and unpressed.

Radio Button Group

Host for a group of radio buttons. This control has the "Push Like" flag which allows you to transform the radio buttons it contains into push buttons with two states (pressed and unpressed). Also, you can set the "Has Border" flag which removes the radio button group's grey background and shows it's border and the "Text" field's value (by default it's "RadioButtonGroup").

Radio Button

Displays a basic radio button. A group of radio buttons enable the user to select a string or integer value for a property from a predetermined list of values.

Group Box

The control displays a rectangle, possibly with caption text, that serves to group other controls together on the dialog box.

Path Edit

This control displays an edit field that enables a user to select the end section of a path. It supports entering the selected folder name or the entire path in the edit field. A user can also enter a Universal Naming Convention (UNC) path to a drive that has no drive letter. If the user enters an end segment for the path that is invalid for the present volume, Path Edit control cannot transfer the focus to the next control.

Masked Edit

An edit field with a mask in the text field. The masked edit can receive only a digit where "#" is used and a digit or a character where "?" is used. Also, in the "Text" field you can set your own custom format for the data entered in the masked edit box.

Scrollable Edit Box

Displays a RTF text. A common use for this control is displaying the license agreement.

Icon

Displays a static picture of an icon.

Bitmap

The control displays a bitmap or JPEG static picture file.

Horizontal Line

Displays a horizontal line.

Vertical Line

Displays a vertical line.

Combo Box

The control displays a drop-down list of predefined values and an edit field into which the user can enter a value. In order to set the combo box's values, you simply double-click it and add your values. The final value of the combo box (the one that is shown in the combo's edit field) will be stored in the property specified in the "Property Name" field.

List Box

The control is a regular list box that enables the user to make a single selection from a list of predetermined values. These values can be set by double-clicking the control and adding them. The final value of the list box will be stored in the property specified in the "Property Name" field.

List View

The control that displays 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 from a predetermined list. These values can be set by double-clicking the control and adding them. The final value of the list view will be stored in the property specified in the "Property Name" field.

Check List

The control is a regular list box with check-boxes, that enables the user to make a multiple selection from a list of predetermined values. These values can be set by double-clicking the control and adding them. When multiple items are selected, their comma separated values will be stored in the property specified in the "Property Name" field. You can customize the separator token to be used for multiple selected values.

Directory List

This control displays a part of the path that is currently displayed in the Path Edit control. The Directory List control displays the folders below the directory currently displayed by the Directory Combo control. This control is usually used in a "Browse" dialog (you can see an example in the "BrowseDlg" dialog under "FolderDlg").

Volume Cost List

The Volume CostList control presents information about the cost associated with the selection on the different volumes. The control shows all the volumes involved in the current installation plus all volumes that are of the types specified in the attribute bits. If the required disk space exceeds the amount available on some drive, the volume is highlighted in the table. Clicking a column header sorts the volumes according to the chosen column.

Directory Combo

This control displays a part of the path that is currently displayed in the Path Edit control. It does not show the last segment of the path, that segment is displayed by the Directory List control. For this control you can set the flags RemovableVolume, FixedVolume, RemoteVolume, CDROMVolume, RAMDiskVolume, and FloppyVolume according to your needs.

Volume Select Combo

The control enables the user to select a volume from an alphabetical list of volumes. The types of volumes displayed in the list are specified using bits associated with RemovableVolume, FixedVolume, RemoteVolume, CDROMVolume, RAMDiskVolume, and FloppyVolume control attributes.

Selection Tree

This control enables a user to change the selection state of features listed in the Feature table. The control is associated with a string valued property that the user can set by a Browse dialog.

Quick Selection Tree

The Quick Selection Tree is an improvement to the simple Selection Tree. The regular Selection Tree control offers a drop-down menu for each feature where you select whether that feature will or will not be installed. The Quick Selection Tree control replaces the drop-down menu with checkboxes. You can read more about this control in Enhanced User Interface page.

Prerequisite Selector

The Prerequisite Selector displays the feature-based prerequisites states. It also allows the user to select which prerequisite to install.

Prerequisites are displayed together with additional information like: required versions, versions found on target computer and action that will be performed.

Progress

A bar that changes its length as it receives progress messages. If you set the "Progress 95" flag then the bar is drawn as a series of small rectangles in Microsoft Windows 95 style.

Billboard Host

This control displays commonly used billboard controls.

The following controls can be placed on a billboard host control:

• Static Text
• Scrollable Text
• Line
• Group Box
• Icon
• Bitmap

Billboard host controls are most typically associated with progress actions.

Hyperlink

The Hyperlink control displays a HTML link to an address, which opens in the default browser for the computer. Links are not supported for protocols other than HTTP.

HTML Host

The HTML Host control displays an HTML page from a given URL or a local file. The associated HTML page can be static or dynamic by using JavaScript (embedded or external).

For more information about using the HTML Host control and its APIs read this article.