RadioButtonGroupByKey 

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

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 RadioButtonGroupByIndex UI element has a completely different concept (see section Data Binding).. The displayed texts are those from the ValueSet or the ABAP Dictionary domain values of the attribute to which the property selectedKey is linked.

To enable the development of accessible 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

 

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 Data Binding within Web Dynpro generally, and Data Binding of UI Element Properties, and Data Binding Using Keys.

Implementation Details

Properties in the View Designer

Name	Type	Initial Value	Bindable
ID	STRING	(automatic)	No
accessibilityDescription	Translatable text		Yes
activateAccessKey	WDY_BOOLEAN	false	No
colCount	I	1	Yes
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	No
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		No
enabled	WDY_BOOLEAN	true	Yes
keyVisible	WDY_BOOLEAN	false	Yes
readOnly	WDY_BOOLEAN	false	Yes
selectedKey	STRING		Mandatory
state	WDUI_STATE	normal	Yes
textDirection	WDUI_TEXT_DIRECTION	inherit	Yes
tooltip	Translatable text		Yes
visible	WDUI_VISIBILITY	visible	Yes
width	STRING		Yes

 

Events in the View Designer

Name

onSelect

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

·   UIElement

·   ContextMenuProvider

·   ViewElement

Dynamic Programming

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

Dynamic Programming of Properties

View Designer Name	Runtime Name	Type
accessibilityDescription	ACCESSIBILITY_DESCR	WDY_MD_TRANSLATABLE_TEXT
activateAccessKey	ACTIVATE_ACCESS_KEY	WDY_BOOLEAN
colCount	COL_COUNT	I
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_RADIOBUTTON_GROUP_BY_KEY=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_RADIOBUTTON_GROUP_BY_KEY=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_RADIOBUTTON_GROUP_BY_KEY=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
enabled	ENABLED	WDY_BOOLEAN
keyVisible	KEY_VISIBLE	WDY_BOOLEAN
readOnly	READ_ONLY	WDY_BOOLEAN
selectedKey	SELECTED_KEY	STRING
state	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
textDirection	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
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	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
width	WIDTH	STRING

 

Dynamic Programming of Events

View Designer Name	Runtime Name
onSelect	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.