Start of Content Area

Background documentation RadioButtonGroupByKey Locate the document in its SAP Library structure

The RadioButtonGroupByKey UI element groups multiple RadioButtons in a table. Unlike UI element CheckBoxGroup, this UI element allows user to select one element only.

Example of the Visual Display

This graphic is explained in the accompanying text

The dropdown list box UI elements, RadioButtonGroup and RadioButtonGroupByIndex, do not differ from each other when displayed on the screen. However, the data binding model for the RadioButtonGroupByKey UI element has a completely different concept (see section Data Binding).

Note

To enable the development of Structure linkaccessible applications, the accessibilityDescription property is checked during the syntax check if the tooltip property is not set.

 

Runtime Class

CL_WD_RADIOBUTTON_GROUP_BY_KEY

 

Properties in View Designer

Name

Type

Initial Value

Bindable

ID

STRING

(automatic)

No

Structure linkaccessibilityDescription

Translatable text

 

Yes

Structure linkcolCount

I

1

Yes

Structure linkenabled

WDY_BOOLEAN

true

Yes

Structure linkkeyVisible

WDY_BOOLEAN

false

Yes

Structure linkreadOnly

WDY_BOOLEAN

false

Yes

Structure linkselectedKey

STRING

 

Mandatory

Structure linkstate

WDUI_STATE

normal

Yes

Structure linktextDirection

WDUI_TEXT_DIRECTION

inherit

Yes

Structure linktooltip

Translatable text

 

Yes

Structure linkvisible

WDUI_VISIBILITY

visible

Yes

Structure linkwidth

STRING

 

Yes

 

Events in View Designer

Name

Structure linkonSelect

Note

Other properties that can be inherited are defined in the associated higher-level classes. The associated UI elements are:

        Structure linkMenuItem

        Structure linkViewElement

Data Binding

The values for the DropDownByKey are determined from the value set of the attribute bound to the property selectedKey. If the attribute has an ABAP Dictionary type and if fixed domain values are defined for this type, these values are used. The text for the respective value is displayed in the list and in the DropDownByKey field.

See Structure linkData Binding within Web Dynpro generally, and Structure linkData Binding of UI Element Properties, and Structure linkData Binding Using Keys.

Dynamic Programming

For dynamic programming, the same properties, events and aggregations are available as in the View Designer. Bear in mind the different spellings.

Dynamic Programming of Properties

View Designer Name

Runtime Name

Type

Structure linkaccessibilityDescription

ACCESSIBILITY_DESCR

WDY_MD_TRANSLATABLE_TEXT

Structure linkcolCount

COL_COUNT

I

Structure linkenabled

ENABLED

WDY_BOOLEAN

Structure linkkeyVisible

KEY_VISIBLE

WDY_BOOLEAN

Structure linkreadOnly

READ_ONLY

WDY_BOOLEAN

Structure linkselectedKey

SELECTED_KEY

STRING

Structure linkstate

STATE

WDUI_STATE

 state: normal

CL_WD_RADIOBUTTON_GROUP_BY_IDX=>E_STATE-NORMAL

 state: required

CL_WD_RADIOBUTTON_GROUP_BY_KEY=>E_STATE-REQUIRED

Structure linktextDirection

TEXT_DIRECTION

WDUI_TEXT_DIRECTION

 textDirection: inherit

CL_WD_RADIOBUTTON_GROUP_BY_KEY=>E_TEXT_DIRECTION-INHERIT

 textDirection: ltr

CL_WD_RADIOBUTTON_GROUP_BY_KEY=>E_TEXT_DIRECTION-LTR

 textDirection: rtl

CL_WD_RADIOBUTTON_GROUP_BY_KEY=>E_TEXT_DIRECTION-RTL

Structure linktooltip

TOOLTIP

WDY_MD_TRANSLATABLE_TEXT

Structure linkvisible

VISIBLE

WDUI_VISIBILITY

 visible: none

CL_WD_RADIOBUTTON_GROUP_BY_KEY=>E_VISIBLE-NONE

 visible: visible

CL_WD_RADIOBUTTON_GROUP_BY_KEY=>E_VISIBLE-VISIBLE

Structure linkwidth

WIDTH

STRING

 

Dynamic Programming of Events

View Designer Name

Runtime Name

Structure linkonSelect

ON_SELECT

Example

You can find examples of this interface element in the system in the Web Dynpro application WDR_TEST_UI_ELEMENTS, and in the component WDR_TEST_EVENTS in the view RadiobtnGrpByKey.

 

 

End of Content Area