Summary
Creates custom dialogs that can gather information not handled by
the default installer template.
Parameters
| Attribute |
Type |
Description |
Required |
| name |
string |
A name used to refer to the dialog. |
True |
| hcenter |
int |
Horizontal position of the dialog box. The range is 0 to 100, with 0 at the left edge of the screen and 100 at the right edge. |
True |
| vcenter |
int |
Vertical position of the dialog box. The range is 0 to 100, with 0 at the top edge of the screen and 100 at the bottom edge. |
True |
| width |
int |
Width of the rectangular boundary of the dialog box. This number must be non-negative. |
True |
| height |
int |
Height of the rectangular boundary of the dialog box. This number must be non-negative. |
True |
| attr |
int |
A 32-bit word that specifies the attribute flags to be applied to this dialog box. This number must be non-negative.
DescriptionVisibleModalMinimizeSysModalKeepModelessTrackDiskSpaceUseCustomPaletteRTLRORightAlignedLeftScrollBiDiError
| Value |
| 1 |
| 2 |
| 4 |
| 8 |
| 16 |
| 32 |
| 64 |
| 128 |
| 256 |
| 512 |
| 896 |
| 65536 |
More information here: http://msdn.microsoft.com/library/en-us/msi/setup/dialog_style_bits.asp
|
True |
| title |
string |
A localizable text string specifying the title to be displayed in the title bar of the dialog box. |
True |
| firstcontrol |
string |
An external key to the second column of the Control table. Combining this field with the Dialog field identifies a
unique control in the Control table. This defines the control that takes the focus when the dialog box is created. This
column is ignored in an Error dialog box.
Because static text cannot take the focus, a Text control that describes an Edit, PathEdit, ListView, ComboBox or
VolumeSelectCombo control must be made the first control in the dialog box to ensure compatibility with screen readers.
|
True |
| defaultcontrol |
string |
An external key to the second column of the Control table. Combining this field with the Dialog field results in
a primary key into the Control table that defines the default control. Hitting the Return key is equivalent to clicking
on the default control. If this column is left blank, then there is no default control. This column is ignored in the
Error dialog box.
|
True |
| cancelcontrol |
string |
An external key to the second column of the Control table. Combining this field with the Dialog field results in
a primary key of the Control table that defines the cancel control. Hitting the ESC key or clicking the Close button in
the dialog box is equivalent to clicking on the cancel control. This column is ignored in an Error dialog box.
The cancel control is hidden during rollback or the removal of backed up files. The protected UI handler hides the control
upon receiving a INSTALLMESSAGE_COMMONDATA message.
|
True |
Examples
Add a web folder dialog:
<dialogs>
<dialog name="WebFolderDlg" hcenter="50" vcenter="50" width="370" height="270" attr="39" title="[ProductName] [Setup]" firstcontrol="Next" defaultcontrol="Next" cancelcontrol="Cancel" />
</dialogs>
Syntax
[BuildElement("dialogs", ProcessXml = false)]
public SchemaElement[] InstallerDialogsElement { get; set; }
Attributes
| Type |
Description |
| BuildElement |
|
Value
| Type |
Description |
| SchemaElement[] |
|
