Show TOC Start of Content Area

Object documentation RadioButtonGroupByIndex This graphic is explained in the accompanying text  Locate the document in its SAP Library structure

Definition

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.

Description of UI Element Properties

      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.

required

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.

inherit

The text direction is inherited from the parent element. The text direction is therefore identical to that of the parent element.

ltr

The text runs from left to right.

rtl

The text runs from right to left.

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.

Properties Overview

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

Events

      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

Data Binding

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.

 

End of Content Area