Start of Content Area

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 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 Structure linkaccessible applications, the tooltip property is checked during the syntax check if the properties text and label 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 View Designer

Name

Type

Initial Value

Bindable

ID

STRING

(automatic)

No

Structure linkenabled

WDY_BOOLEAN

true

Yes

Structure linkexplanation

Translatable text

 

No

Structure linkkeyToSelect

STRING

 

Yes

Structure linkkeyVisible

WDY_BOOLEAN

false

Yes

Structure linkreadOnly

WDY_BOOLEAN

false

Yes

Structure linkselectedKey

STRING

 

Mandatory

Structure linkstate

WDUI_STATE

normal

Yes

Structure linktext

Translatable text

 

Yes

Structure linktextDirection

WDUI_TEXT_DIRECTION

inherit

Yes

Structure linktooltip

Translatable text

 

Yes

Structure linkvisible

WDUI_VISIBILITY

visible

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

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 linkenabled

ENABLED

WDY_BOOLEAN

Structure linkexplanation

EXPLANATION

WDY_MD_TRANSLATABLE_TEXT

Structure linkkeyToSelect

KEY_TO_SELECT

STRING

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=>E_STATE-NORMAL

 state: required

CL_WD_RADIOBUTTON=>E_STATE-REQUIRED

Structure linktext

TEXT

WDY_MD_TRANSLATABLE_TEXT

Structure linktextDirection

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

Structure linktooltip

TOOLTIP

WDY_MD_TRANSLATABLE_TEXT

Structure linkvisible

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

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

 

 

End of Content Area