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