Entering content frame

Background documentation RadioButton Locate the document in its SAP Library structure

The RadioButton UI element is a button with two states (on/off) that enables the user 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 keyToSelectproperty.

Note

If the properties text and label have not been set, the property tooltip is checked during the design time to ensure Accessibility.

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

enabled

WDY_BOOLEAN

true

Yes

explanation

Text

 

No

keyToSelect

STRING

 

Yes

keyVisible

WDY_BOOLEAN

false

Yes

readOnly

WDY_BOOLEAN

false

Yes

selectedKey

STRING

 

mandatory

state

WDUI_STATE

normal

Yes

text

Text

 

Yes

textDirection

WDUI_TEXT_DIRECTION

inherit

Yes

tooltip

Text

 

Yes

visible

WDUI_VISIBILITY

visible

Yes

 

Events in the View Designer

Name

onSelect

Note

Further properties that can be inherited are defined in the associated higher-level class.  The associated interface elements are:

·         UIElement

·         ViewElement

Dynamic Programming

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

Dynamic Programming of Properties

View Designer Name

Runtime Name

Type

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.

 

 

Leaving content frame