Dialog Table

[This is preliminary documentation and subject to change.]

The Dialog table contains all the dialogs that appear in the user interface in both full and reduced modes.

The Dialog table has the following columns.

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

Columns

Dialog
Primary key, name of the dialog.
Hcentering
Horizontal position of the dialog on a 0-100 scale.

Range = 0 to 100 (0 is the left edge of the screen, 100 is the right edge).

Vcentering
Vertical position of the dialog on a 0-100 scale.

Range = 0 to 100. (0 is the top of the screen, 100 is the bottom).

Width
Width of the bounding rectangle of the dialog.

Non-negative numbers only.

Height
Height of the bounding rectangle of the dialog.

Non-negative numbers only.

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

Non-negative numbers only. For a list of options, see Dialog Stylebits List.

Title
A text string specifying the title to be displayed in the title bar of the dialog window.
Control_First
An external key that, combined with the Dialog column, forms the primary key of the Control table. This defines the control that has the focus when the dialog is created. This column is ignored on the Error dialog.

External key to column two of the Control table.

For compatibility with screen readers, when authoring a dialog with an Edit, PathEdit, ListView, ComboBox or VolumeSelectCombo control as the first active control, you must make the text field belonging to the edit field the first active control in this column. Since static text can not take focus, when the dialog is created the edit field has the focus initially as intended — but doing this ensures that screen readers show the correct information.

Control_Default
An external key that, combined with the Dialog entry, forms the primary key of the Control table. This defines the default control (that is, hitting the Return key is equivalent to clicking this control). If this column is left blank, no default control is defined. This column is ignored on the Error dialog.

External key to column two of the Control table.

Control_Cancel
An external key that, combined with the Dialog entry, forms the primary key of the Control table. This defines the cancel control (that is, hitting the Esc key or clicking the Close icon on the dialog is equivalent to clicking this control). If this column is left blank, no cancel control is defined. This column is ignored on the Error dialog.

External key to column two of the Control table.

Remarks

The integer values for width and height are in the installer units, not dialog units. An installer unit is equal to one-twelfth the height of the system font.

Wizard Dialogs

The two centering values are ignored for subsequent dialogs in a wizard sequence (that is, those created by a NewDialog ControlEvent). Subsequent dialogs display in the same position as the previous dialog, as defined by the author, or as positioned by the user.