A list of controls that can be used on a installer dialog.
- Static Text
- Edit Box
- Push Button
- Check Box
- Radio Button Group
- Radio Button
- Group Box
- Path Edit
- Masked Edit
- Scrollable Edit Box
- Icon
- Bitmap
- Horizontal Line
- Combo Box
- List Box
- List View
- Directory List
- Volume Cost List
- Directory Combo
- Volume Select Combo
- Selection Tree
- Progress
- Billboard Host
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 value of the edit control 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. This is recommended for buttons
that trigger actions which need administrative privileges (for example
the "Install" button).
Check Box
A two-state check box. The check box is
used to establish one of two possible states (checked and unchecked).
The property of the check box will be empty until the check box is
checked (the value of the property 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
grey background of the radio button group and shows it's border and the
value of the "Text" field (by default it's "RadioButtonGroup").
The value of the property of the radio button group will be set to
the value of the selected radio button.
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.
This control cannot be placed outside a Radio Button Group
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.
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 values of the combo box you simply
double-click it and add your values. The final value of the combo box
(the one that is shown in the edit field of the combo) 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.
The "Sort By Index" flag allows you to sort the values in the list
box by their index or alphabetically.
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.
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.
This control must use the same property used by the Path Edit
control.
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.
Progress
A bar that changes its length as it
receives progress messages. If you set the "Progres 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 most typically associated with progress actions.
You can add only one billboard host control on a dialog.
- Introduction
- Using Advanced Installer
- Features and Functionality
- Tutorials, How To's, Q&A
- Windows Installer