RadioButton

Verwendung

Das RadioButton-Oberflächenelement repräsentiert einen Schalter mit zwei Zuständen (An/Aus), das dem Benutzer ermöglicht, Optionen auszuwählen. Sie können das RadioButton-Oberflächenelement dann verwenden, wenn Sie die einzelnen RadioButtons auf dem Bildschirm nicht tabellarisch in einer Gruppe, sondern verteilt darstellen möchten. Die Umschaltfunktion des RadioButtons wird dann ermöglicht, wenn Sie die Oberflächenelemente an das gleiche Context-Attribut binden.

Der RadioButton ist genau dann ausgewählt, wenn das Context-Attribut, an das die Eigenschaft selectedKey gebunden ist, den Wert des zu diesem Auswahlknopf gehörigen Schlüssels enthält. Dieser Schlüssel wird durch die Eigenschaft keyToSelect gesetzt.

RadioButton.state=normal

RadioButton.state=required

Barrierefreiheit

Um die Entwicklung barrierefreier Anwendungen zu ermöglichen, wird im Rahmen des Syntaxchecks die Eigenschaft tooltipüberprüft, wenn die Eigenschaften text und label nicht gesetzt wurden.

Ein gesetzter tooltip ist bei diesem Oberflächenelement nicht zwingend erforderlich, könnte aber - wenn er detaillierte semantische Informationen enthält - durchaus Sinn machen.

Implementierungsdetails

Laufzeit-Klasse

CL_WD_RADIOBUTTON

Name	Typ	Anfangswert	Bindbar
id	STRING	(automatisch)	nein
activateAccessKey	WDY_BOOLEAN	false	nein
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
displayOnly	WDY_BOOLEAN	false	ja
enabled	WDY_BOOLEAN	true	ja
explanation	Übersetzbarer Text		nein
keyToSelect	STRING		ja
keyVisible	WDY_BOOLEAN	false	ja
readOnly	WDY_BOOLEAN	false	ja
selectedKey	STRING		muss
state	WDUI_STATE	normal	ja
styleClassName	STRING		ja
text	Übersetzbarer Text		ja
textDesign	WDUI_RADIOBUTTON_TEXT_DESIGN	standard	ja
textDirection	WDUI_TEXT_DIRECTION	inherit	ja
textWrapping	WDY_BOOLEAN	false	ja
tooltip	Übersetzbarer Text		ja
visible	WDUI_VISIBILITY	visible	ja

Name
onSelect

Weitere Eigenschaften, die über Vererbung zur Verfügung stehen, sind in den dazugehörigen übergeordneten Klassen definiert. Die dazugehörigen Oberflächenelemente sind:

Dynamische Programmierung

Für die dynamische Programmierung stehen dieselben Eigenschaften, Ereignisse und Aggregationen zur Verfügung wie im View Designer. Beachten Sie dabei die unterschiedlichen Schreibweisen.

View Designer Name	Laufzeitname	Typ
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
displayOnly	DISPLAY_ONLY	WDY_BOOLEAN
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
styleClassName	STYLE_CLASS_NAME	STRING
text	TEXT	WDY_MD_TRANSLATABLE_TEXT
textDesign	TEXT_DESIGN	WDUI_RADIOBUTTON_TEXT_DESIGN
textDesign: standard	CL_WD_RADIOBUTTON=>E_TEXT_DESIGN-STANDARD
textDesign: emphasized	CL_WD_RADIOBUTTON=>E_TEXT_DESIGN-EMPHASIZED
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
textWrapping	TEXT_WRAPPING	WDY_BOOLEAN
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	Laufzeitname
onSelect	ON_SELECT

Beispiel

Beispiele zum Testen für dieses Oberflächenelement finden Sie im System in der Web-Dynpro-Applikation WDR_TEST_UI_ELEMENTS sowie in der Component WDR_TEST_EVENTS in der View Radiobutton.