Start of Content Area

Background documentation RadioButton  Locate the document in its SAP Library structure

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 spread the displayed radio buttons individually on the screen instead of grouping them in a table. You can toggle the radio button when you bind the UI elements to the same context attribute.

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

Note

To enable the development of accessible applications, the tooltip property is checked during the syntax check if the text and 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.

 

Runtime Class

CL_WD_RADIOBUTTON

 

Properties in the View Designer

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

 

Events in the View Designer

Name

onSelect

Note

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

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

 

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 Radiobutton.

 

 

End of Content Area