The command mode syntax for the Dialog command consists of a set of basic parameters and a set of parameters for each control in the custom dialog.
Parameter sets are enclosed in parentheses. By default, a Dialog command includes a set of parameters for the dialog itself and the OK/Cancel button set.
Parameter sets for other controls follow the button set.
DIALOG (DIALOG TITLE "text" WIDTH px_value HEIGHT px_value WAIT n) (BUTTONSET TITLE "&OK;&Cancel" AT x_coord y_coord DEFAULT number <HORZ>) <other_parameter_sets>
(CHECKBOX TITLE "text" TO "variable" AT x_coord y_coord WIDTH px_value HEIGHT px_value)
(DROPDOWN TITLE "item1;item2;..." TO "variable" AT x_coord y_coord WIDTH px_value HEIGHT px_value DEFAULT number)
(EDIT TO "EDIT1" AT x_coord y_coord WIDTH px_value HEIGHT px_value DEFAULT "text" <CHAR|NUM|DATE|FILE>)
(ITEM TITLE "item_index" TO "variable" AT x_coord y_coord WIDTH px_value HEIGHT px_value DEFAULT "item_category")
(RADIOBUTTON TITLE "item1;item2;..." TO "variable" AT x_coord y_coord WIDTH px_value HEIGHT px_value DEFAULT number <HORZ>)
(TEXT TITLE "text" AT x_coord y_coord WIDTH px_value HEIGHT px_value)
| • | text specifies a text string |
| • | px_value specifies a pixel value for the Width or Height parameters of an individual control. If no pixel values are manually specified for a control, the pixel width and height are automatically calculated based on the longest value for the control |
| • | x_coord y_coord specifies the horizontal and vertical position of the upper left corner of the control |
| • | number corresponds to the order in which items are specified. In the above OK/Cancel button set, [OK] is 1 and [Cancel] is 2 |
| • | variable specifies the name of the variable to store the user-determined value |
| • | item1;item2;... specifies the labels for the options within the control |
| • | item_index specifies categories in a Project item list. Each category is represented by a letter |
| • | item_category specifies the default Project item category |
| • | HORZ is an optional parameter to display the OK & CANCEL buttons or radio buttons horizontally rather than vertically (the default) |
Project Item Category Syntax
|
Project Item Category |
Index |
|
Procedures |
b |
|
Character Fields |
C |
|
Character Variables |
c |
|
Date Fields |
D |
|
Date Variables |
d |
|
Indexes |
i |
|
Table Layouts |
f |
|
Logical Fields |
L |
|
Logical Variables |
l |
|
Numeric Fields |
N |
|
Numeric Variables |
n |
|
Views |
r |
|
Workspaces |
w |