Name
radio-group — A group of radio-buttons.
Synopsis
<radio-group
/>(
|
name (required) , |
| annotation (optional) , | |
| initial-enable (optional) , | |
| enabled (optional) , | |
| instantiate (optional) , | |
| control-udt (optional) , | |
| xsd-stub-xhtml (optional) , | |
| width (optional) , | |
| height (optional) , | |
| error-glyph (optional) , | |
| auto-submit (optional) , | |
| column (optional) , | |
| debug-srcfile (optional) , | |
| debug-srcline (optional) , | |
debug-log
(optional) ); |
Description
This control is used to group containing radio-buttons in a group. This ensures that only one button is selected at a time. Note: This control is not mandatory for making such group of buttons, another option is to use 'group-name' attribute of the radio-button control.
Attributes
- name = SqlName
-
A page level unique name identifying a control.
- annotation
-
A human readable comment.
- initial-enable = CalculableValue
-
Determines whether a control is initially visible. True by default. Could be data-bound to an SQL expression.
- enabled = CalculableValue
-
Determines whether a control is visible. True by default. Could be data-bound to an SQL expression.
- instantiate = CalculableValue
-
Determines whether a control instantiates its children. It is true by default. It could be data-bound to an SQL expression. Unlike most of calculable attributes, the value of this attribute for a control is calculated before calling 'on-init' event handler of the control; other values are calculated before calling 'before-data-bind' event handler.
- control-udt = SqlName
-
At run time every control is represented as an instance of some user-defined type (UDT). VSPX compiles and selects the UDT to use depending on name of the XML element that represents the control and maybe some of its attributes. In some specific cases the application developer may instruct VSPX compiler to use some other UDT, e.g. an application-specific UDT that is derived from the preset one. If specified, the value of 'control-udt' attribute should be equal to the name of the desired target UDT.
- xsd-stub-xhtml
-
This attribute is for internal use only. It has no effect if added to the source VSPX file.
- width
-
Visible width of the control when it is displayed in WYSIWYG tools when the source VSPX text is edited. The value of this attribute will not be used when the resulting HTML is rendered.
- height
-
Visible height of the control when it is displayed in WYSIWYG tools when the source VSPX text is edited. The value of this attribute will not be used when the resulting HTML is rendered.
- error-glyph
-
The character to be displayed near the resulting HTML input element if the test of v:validator of the element detects an error in the current value of the element.
- auto-submit
-
Flag to auto submit the parent form if value of the control is changed.
- column = SqlName
-
The name of the column bound. If nothing else is specified, the column meta data from the containing update form sets the field's attributes.
- debug-srcfile
-
URI of the source document where the tag comes from.
- debug-srcline
-
Line number in the source document where the tag comes from.
- debug-log
-
This defines what sort of data are saved to the debugging log.
Declaration of type vspx_radio_group
create type vspx_radio_group under vspx_field
temporary self as ref
constructor method vspx_radio_group (name varchar, parent vspx_control),
method vc_choose_selected () returns any,
overriding method vc_xrender () returns any,
overriding method vc_set_model () returns any
Examples
Example 14.40. Groups of radio buttons.
The form contains a groups of radio buttons, grouped with radio-group control.
<v:page name="radio_group_demo" xmlns:v="http://http://example.com/vspx/">
<html>
<body>
<v:form name="sf" type="simple" method="POST">
<v:radio-group name="radio00">
<v:radio-button name="radiob01" value="--'one'" />
<v:radio-button name="radiob02" value="--'two'" />
</v:radio-group>
</v:form>
</body>
</html>
</v:page>
![[Tip]](images/tip.png)