CHECKGRP

PLBCMP GUI Only

The CHECKGRP instruction defines an object variable for a group of standard GUI check boxes. A CHECKGRP presents several options to the user. The user can check an option box to select the option or uncheck the box to deselect it. To define a CHECKGRP, use one of the following statement formats:

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

A CHECKGRP contains as many items as there are check boxes.
The entire CHECKGRP is referenced as item number zero. Individual check boxes are referenced according to their respective number.
The value of a CHECKGRP is the item in the list that is currently selected.
The CHECKGRP may have an optional title and border.
The text associated with each item in the CHECKGRP may include an Alt Keyboard Sequence.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes a Pointer Variable.
Although a CHECKGRP may be defined as Global, it is DESTROYed during a CHAIN instruction.
This object is not available when using the PL/B Web Server.