DIALOG

PLBCMP GUI Only

The DIALOG instruction defines an object variable for a standard GUI dialog. DIALOGs allow the grouping of various controls into a single window. To define a DIALOG, use one of the following statement formats:

(1)	[label]	DIALOG	[%]
(2)	[label]	DIALOG	(arraysize)
(3)	[label]	DIALOG	^
(4)	[label]	DIALOG	^,{target}
(5)	[label]	DIALOG	^(arraysize)
(6)	[label]	DIALOG	^(arraysize),({target}),...,({target})

Where:

label

Optional. A Data Label.

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

DIALOGs are an obsolete object type and have been superseded by using the WINTYPE property set to $MODAL for a WINDOW object.
The DIALOG object is an obsolete data type.
A DIALOG may contain many elements. Each element of the dialog is one item.
The entire DIALOG is referenced as item number zero.
Items are accessible through the SETITEM or GETITEM instructions.
Elements of the DIALOG may be buttons, radio buttons, check boxes, icons, pop-up menus, datalists, static text items, and edit text items.
Each element of the dialog has its own unique item number.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes a Pointer Variable.
DIALOG is not supported by the PLBCE runtime.
Although a DIALOG may be defined as Global, it is DESTROYed during a CHAIN instruction.
The DIALOG object is not implemented for the Application Server because it is an obsolete object.
DIALOGs cannot be scaled using the WINDOW Scale method.
This object is not available when using the PL/B Web Server.