CHECKBOX

PLBCMP GUI Only

The CHECKBOX instruction defines an object variable for a standard GUI check box. A CHECKBOX presents a true/false or yes/no option to the user. The user can check the box to select the option or clear it to deselect the option. To define a CHECKBOX, use one of the following statement formats:

(1)	[label]	CHECKBOX	[%]
(2)	[label]	CHECKBOX	(arraysize)
(3)	[label]	CHECKBOX	^
(4)	[label]	CHECKBOX	^,{target}
(5)	[label]	CHECKBOX	^(arraysize)
(6)	[label]	CHECKBOX	^(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 CHECKBOX contains only one item accessible through SETITEM. It is the check box.
The CHECKBOX is always referenced as item number zero for SETITEM and GETITEM instructions.
The text displayed adjacent to a CHECKBOX is specified when it is CREATEd. Subsequently, it may be modified or retrieved using the SETITEM and GETITEM instructions.
A CHECKBOX is considered set if the value of the object is one and clear if the value is zero.
The runtime only performs the default action of changing the state of the CHECKBOX if there is no user code associated with the object during activation.
The text associated with a CHECKBOX may include an Alt Keyboard Sequence.
CHECKBOXes may be grouped together for navigational purposes using the GROUPID property.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes a Pointer Variable.
Although a CHECKBOX may be defined as Global, it is DESTROYed during a CHAIN instruction.
The SETMODE *SUBTABFORENTER control alters the ENTER key behavior of a CHECKBOX.