RADIOGRP

PLBCMP GUI Only

The RADIOGRP instruction defines an object variable for a group of radio buttons. Radio buttons present a set of mutually exclusive options to the user - that is, only one radio button in a group may be selected at any time. When the user selects a radio button, the previously selected button becomes unselected. To define a RADIOGRP, use one of the following statement formats:

(1)	[label]	RADIOGRP	[%]
(2)	[label]	RADIOGRP	(arraysize)
(3)	[label]	RADIOGRP	^
(4)	[label]	RADIOGRP	^,{target}
(5)	[label]	RADIOGRP	^(arraysize)
(6)	[label]	RADIOGRP	^(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 RADIOGRP contains as many items as there are radio buttons.
The entire RADIOGRP is referenced as item number zero. Individual radio buttons are referenced according to their respective number.
Items are accessible through the SETITEM or GETITEM instructions.
The value of a RADIOGRP is the item of the list that is currently selected.
The RADIOGRP may have an optional title and border.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes Pointer Variable.
Although a RADIOGRP may be defined as Global, it is DESTROYed during a CHAIN instruction.
This object is not available when using the PL/B Web Server.