[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 |
Range = 0 to 100 (0 is the left edge of the screen, 100 is the right edge).
Range = 0 to 100. (0 is the top of the screen, 100 is the bottom).
Non-negative numbers only.
Non-negative numbers only.
Non-negative numbers only. For a list of options, see Dialog Stylebits List.
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.
External key to column two of the Control table.
External key to column two of the Control table.
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.