UI element RadioButtonGroupByIndex groups a number of radio buttons in a single table. Unlike UI element CheckBoxGroup, this UI element allows user to select one element only.
● accessiblityDescription
When accessibility is activated, the assigned text is added to the quick info. This description provides semantic details of the UI element and is only read by the screen reader if the user focuses the complete Ul element.
● colCount
Specifies the number of columns in which the radio button UI elements are displayed.
● readOnly
Specifies whether or not the user can select a radio button within the radio button group.
● selectionChangeBehaviour
Property selectionChangeBehaviour can take the following values and is represented by t enumeration type TextDirection.
● auto |
● Specifies that the UI element automatically changes the lead selection after an interaction by the user before the corresponding event is triggered. |
● manual |
● Specifies that the UI element does not change the lead selection after an interaction by the user but triggers the corresponding event. In this case, the event handler must change the lead selection to enable the UI element to display the data. This setting allows you to check changes made to the lead selection. |
● state
Describes
the state of the UI element.
Property state can take the
following values and is represented by enumeration type WDState.
normal |
Describes the default state of the UI element. |
Specifies whether the entered value is required. |
● textDirection
Specifies the text direction and allows you to use a check box for texts in languages which require a specific text direction. Property textDirection can take the following values and is represented by enumeration type WDTextDirection.
The text direction is inherited from the parent element. The text direction is therefore identical to that of the parent element. |
|
The default value for this property is inherit.
● texts
Specifies the path to the context attribute that provides the texts of the radio buttons. The context attribute must be an attribute of a multiple context node which stores the data of the radio buttons. Each node element represents a radio button.
● width
Specifies the width of the UI element that you can specify in CSS sizes, such as em, ex, pixels or percentage values.
Name |
Interface |
Type |
Initial Value |
Bindable |
accessibilityDescription |
IWDRadioButtonGroupByIndex |
String (Translatable Text) |
|
bindable |
colCount |
IWDRadioButtonGroupByIndex |
int |
1 |
bindable |
enabled |
IWDUIElement |
boolean |
true |
bindable |
readOnly |
IWDRadioButtonGroupByIndex |
boolean |
false |
bindable |
selectionChangeBehaviour |
IWDRadioButtonGroupByIndes |
WDLeadSelectionChangeBehaviour |
auto |
not_bindable |
state |
IWDRadioButtonGroupByIndex |
WDState |
normal |
bindable |
textDirection |
IWDRadioButtonGroupByIndex |
WDTextDirection |
inherit |
bindable |
texts |
IWDRadioButtonGroupByIndex |
String |
|
bindable_mandatory |
tooltip |
IWDUIElement |
String |
|
bindable |
visible |
IWDUIElement |
WDVisibility |
visible |
bindable |
width |
IWDRadioButtonGroupByIndex |
String |
|
bindable |
● onSelect
This event is triggered if the user selects a radio button of this RadioButtonGroupByIndex. The parameter index contains the index of the selected radio button.
Event Parameter |
Type |
index |
int |
The context must provide a context node X that can contain 0 to n elements (X.cardinality=0..n). The context node must contain a context attribute y that is of a simple type and provides the texts for the radio buttons. For data binding, property texts is bound to attribute y. Each node element represents a radio button. The selected index is specified by the lead selection of the node X. For further information, see Data Binding of a Dropdown List Box and Radio Button Group and Code Examples of Data Binding.