RadioButton

Use

The RadioButton UI element is a switch with two states (on/off) that enables users to select options. The RadioButton UI element allows you to arrange the RadioButtons individually on the screen instead of grouping them in a table.You can toggle RadioButtons if you bind the UI elements to the same context attribute.

The RadioButton is selected if the context attribute, to which the selectedKey property is bound, contains the value of the key belonging to this radio button. The key is specified by the keyToSelect property.

RadioButton.state=normal

RadioButton.state=required

Accessibility

To enable the development of accessible applications, the tooltip property is checked during the syntax check if the text label properties are not set.

A tooltip does not necessarily have to be set for this UI element, but it could make sense to set it if it contains detailed semantic information.

Implementation Details

Runtime Class

CL_WD_RADIOBUTTON

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

Name
onSelect

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

Dynamic Programming

For dynamic programming, the same properties, events and aggregations are available as in the View Designer. But note that the spelling format and use of upper/lower case is different.

View Designer Name	Runtime Name	Type
activateAccessKey	ACTIVATE_ACCESS_KEY	WDY_BOOLEAN
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_RADIOBUTTON=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_RADIOBUTTON=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_RADIOBUTTON=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
enabled	ENABLED	WDY_BOOLEAN
explanation	EXPLANATION	WDY_MD_TRANSLATABLE_TEXT
keyToSelect	KEY_TO_SELECT	STRING
keyVisible	KEY_VISIBLE	WDY_BOOLEAN
readOnly	READ_ONLY	WDY_BOOLEAN
selectedKey	SELECTED_KEY	STRING
state	STATE	WDUI_STATE
state: normal	CL_WD_RADIOBUTTON=>E_STATE-NORMAL
state: required	CL_WD_RADIOBUTTON=>E_STATE-REQUIRED
text	TEXT	WDY_MD_TRANSLATABLE_TEXT
textDirection	TEXT_DIRECTION	WDUI_TEXT_DIRECTION
textDirection: inherit	CL_WD_RADIOBUTTON=>E_TEXT_DIRECTION-INHERIT
textDirection: ltr	CL_WD_RADIOBUTTON=>E_TEXT_DIRECTION-LTR
textDirection: rtl	CL_WD_RADIOBUTTON=>E_TEXT_DIRECTION-RTL
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_RADIOBUTTON=>E_VISIBLE-NONE
visible: visible	CL_WD_RADIOBUTTON=>E_VISIBLE-VISIBLE

View Designer Name	Runtime Name
onSelect	ON_SELECT

Example

For test purposes 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 Radiobutton view.