Dialog Table

Windows Installer

Dialog Table

The Dialog Table contains all the dialogs that appear in the user interface (UI) in both the full and reduced modes.

The Dialog Table has the following columns.

Column Type Key Nullable
Dialog Identifier Y N
HCentering Integer N N
VCentering Integer N N
Width Integer N N
Height Integer N N
Attributes DoubleInteger N Y
Title Formatted N Y
Control_First Identifier N N
Control_Default Identifier N Y
Control_Cancel Identifier N Y

 

Columns

Dialog

The primary key and name of the dialog box.

HCentering

The 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.

VCentering

The 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.

Width

The width of the rectangular boundary of the dialog box.

This number must be non-negative.

Height

The height of the rectangular boundary of the dialog box.

This number must be non-negative.

Attributes

A 32-bit word that specifies the attribute flags to be applied to this dialog box.

This number must be non-negative. For more information, see Dialog Style Bits.

Title

A localizable text string specifying the title to be displayed in the title bar of the dialog box.

Control_First

An external key to the second column of the Control Table.

Combining this field with the Dialog field specifies a unique control in the Control Table that takes the focus when the dialog box is opened. Typically, this can be an Edit Control, SelectionTree Control, or any other control that can take the focus. If the PushButton Control is the only control present on the dialog box that can take the focus, the PushButton entered in the ControlDefault field must also be entered into the Control First field. This column is ignored in an Error Dialog box.

Because static text cannot take the focus, a Text Control that describes an Edit Control, PathEdit Control, ListView Control, ComboBox Control or VolumeSelectCombo Control must be made the first control in the dialog box to ensure compatibility with screen readers.

Control_Default

An external key to the second column of the Control Table.

Combining this field with the Dialog field specifies the default control that takes focus when the dialog box is opened. Typically, this can be a PushButton Control. If no PushButton Control on the dialog box has the focus, 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 an Error Dialog box.

Control_Cancel

An external key to the second column of the Control Table.

Combining this field with the Dialog field specifies a control that cancels the installation. This control is coupled to events in the ControlEvent Table used to cancel the installation. Hitting the ESC key or clicking the Close button 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 internal UI handler hides the control upon receiving a INSTALLMESSAGE_COMMONDATA message.

 

Remarks

The integer values for width and height are in the Installer Units, not dialog units.

The two centering values are ignored for subsequent dialog boxes in a wizard sequence. Dialog box positions are set by the user or as for the previous dialog box. These dialog box sequences are created by a NewDialog ControlEvent.

Validation

ICE03
ICE06
ICE13
ICE20
ICE23
ICE27
ICE32
ICE44
ICE45
ICE46

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.