RadioButtonGroup

<< Click to Display Table of Contents >>

Navigation:  Interactive Objects >

RadioButtonGroup

Previous pageReturn to chapter overviewNext page

Inserts a Radiobutton Group into the document. It is required that you insert a Radiobutton Group into the document before inserting Radiobuttons. A Radiobutton Group keeps the associated Radiobuttons together, controls the state switching if a button of the group is clicked and holds the value of the group.

method TVPEObject VPE.RadioButtonGroup(

integer DefaultValue

)

integer DefaultValue

the default value of the group
E.g. if a Radiobutton Group has three associated Radiobuttons, say button A with the value 1, button B with the value 2 and button C with the value 3 and you set default_value = 2, then the button B will be checked automatically when it is created and associated with this Group.

Returns:

The VPE Object which represents the control.

The Object is required to associate Radiobuttons with it.

In addition the VPE Object can be used later in your code to, for example, set the input focus on it or to retrieve its value and to change some of its properties.

Remarks:

If you assign a value to a group, which is not defined by any Radiobutton, no Radiobutton is selected, i.e. the visual state of the group is undefined. This feature can be used to reflect NULL values, for example from databases.

Example:

see RadioButton

 

See also:

"Interactive Documents" in the Programmer's Manual.