CREATE DIALOG

PLBCMP GUI Only

Properties

Instructions

The CREATE DIALOG statement initializes a DIALOG object variable. The statement format is:

[label]

CREATE

[{parent};]{dialog},{data}

Where:

label

Optional. A Program Execution Label.

parent

Optional. A previously created WINDOW or PANEL object variable or pointer to a WINDOW or PANEL object on which the object is created.

dialog

Required. The name of a previously defined DIALOG object variable or pointer to a DIALOG object.

data

Required. A Character String Variable, a character Literal, a Numeric Variable, an Expression, or a decimal constant containing a description of the dialog information or a numeric variable or decimal constant specifying the resource number of the DIALOG.

Flags Affected: NONE

Note the following:

The coordinate system used for specifying positions within a DIALOG box is based upon lines and columns or pixel positions. Each line has the height of a button and each column has the width of one character. This coordinate system allows the design of dialog boxes that are independent for operating system and font characteristics.
Character strings used in the definition of DIALOG attributes or DIALOG items must be enclosed in single quotes. Two single quotes together represent one single quotes.
A maximum of 250 DIALOG objects are allowed.
The KEYIN instruction may only input data if the DIALOG type is MODELESS. The KEYIN or DISPLAY statements always use the main window and not the dialog window. If an event is pending during a KEYIN, the F31 flag is set and the KEYIN is terminated.
The tab sequencing of the objects is based on the order they are placed in the data string.
Optional dialog attributes further define the DIALOG.
Dialog items are equivalent to objects within the main window. Dialog items may be manipulated using the standard object instructions. All dialog items are assigned a sequential item number starting at one. Group items are assigned an item number for each member, with the group being treated as the first member.
If the optional {parent} parameter is not specified, the default window is used.