GROUPBOX

PLBCMP GUI Only

The GROUPBOX instruction defines an object variable for a general group box. A GROUPBOX groups related objects on the screen. To define a GROUPBOX, use one of the following statement formats:

(1)	[label]	GROUPBOX	[%]
(2)	[label]	GROUPBOX	(arraysize)
(3)	[label]	GROUPBOX	^
(4)	[label]	GROUPBOX	^,{target}
(5)	[label]	GROUPBOX	^(arraysize)
(6)	[label]	GROUPBOX	^(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:

The GROUPBOX object provides a region enclosed with a border that may have a title associated with it. In addition, other options may be applied to the GROUPBOX.
The GROUPBOX may be overlaid with other objects to provide a custom box area.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes a Pointer Variable.
Although a GROUPBOX may be defined as Global, it is DESTROYed during a CHAIN instruction.