CheckBox

Mit einer CheckBox realisieren Sie das Konzept eines einzelnen An-/Aus-Schalters in Form eines Ankreuzfeldes. Eine CheckBox erlaubt dem Benutzer die Auswahl eines Booleschen Wertes (TRUE/FALSE). Das Oberflächenelement besteht aus einer Grafik mit dazugehörigem Text. Ein Häkchen in der Grafik zeigt an, dass die Option ausgewählt und der Wert auf TRUE gesetzt wurde.

Hinweis Hinweis

Wenn Sie eine Gruppe logisch miteinander in Beziehung stehender CheckBoxen anbieten möchten, verwenden Sie das Oberflächenelement CheckBoxGroup.

Ende des Hinweises.

Beispiel für die visuelle Darstellung
(Beispiel für CheckBox)

Implementierungsdetails

Laufzeit-Klasse

CL_WD_CHECKBOX

Eigenschaften im View Designer
Name	Typ	Anfangswert	Bindbar
id	`STRING`	(automatisch)	nein
activateAccessKey	`WDY_BOOLEAN`	`false`	nein
checked	`WDY_BOOLEAN`	`false`	muss
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
readOnly	`WDY_BOOLEAN`	`false`	ja
state	`WDUI_STATE`	`normal`	ja
text	Übersetzbarer Text		ja
textDesign	`WDUI_CHECKBOX_TEXT_DESIGN`	`standard`	ja
textDirection	`WDUI_TEXT_DIRECTION`	`inherit`	ja
textWrapping	`WDY_BOOLEAN`	`false`	ja
tooltip	Übersetzbarer Text		ja
visible	`WDUI_VISIBILITY`	`visible`	ja

Events im View Designer
Name
onToggle
OnClientAction	SubmitFormAction
	SetFocusAction

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

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 sonst nicht zwingend erforderlich, könnte aber - wenn er detaillierte semantische Informationen enthält - durchaus Sinn machen.

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.

Dynamische Programmierung der Eigenschaften
View Designer Name	Laufzeitname	Typ
activateAccessKey	`ACTIVATE_ACCESS_KEY`	`WDY_BOOLEAN`
checked	`CHECKED`	`WDY_BOOLEAN`
contextMenuBehaviour	`CONTEXT_MENU_BEHAVIOUR`	`WDUI_CONTEXT_MENU_BEHAVIOUR`
`contextMenuBehaviour: inherit`	`CL_WD_CHECKBOX=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT`
c`ontextMenuBehaviour: provide`	`CL_WD_CHECKBOX=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE`
`contextMenuBehaviour: suppress`	`CL_WD_CHECKBOX=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS`
contextMenuId	`CONTEXT_MENU_ID`	`WDY_MD_UI_ELEMENT_REFERENCE`
enabled	`ENABLED`	`WDY_BOOLEAN`
explanation	`EXPLANATION`	`WDY_MD_TRANSLATABLE_TEXT`
displayOnly	`DISPLAY_ONLY`	`WDY_BOOLEAN`
readOnly	`READ_ONLY`	`WDY_BOOLEAN`
state	`STATE`	`WDUI_STATE`
`state: normal`	`CL_WD_CHECKBOX=>E_STATE-NORMAL`
`state: required`	`CL_WD_CHECKBOX=>E_STATE-REQUIRED`
text	`TEXT`	`WDY_MD_TRANSLATABLE_TEXT`
textDesign	`TEXT_DESIGN`	`WDUI_CHECKBOX_TEXT_DESIGN`
`textDesign: standard`	`CL_WD_CHECKBOX=>E_TEXT_DESIGN-STANDARD`
`textDesign: emphasized`	`CL_WD_CHECKBOX=>E_TEXT_DESIGN-EMPHASIZED`
textDirection	`TEXT_DIRECTION`	`WDUI_TEXT_DIRECTION`
`textDirection: inherit`	`CL_WD_CHECKBOX=>E_TEXT_DIRECTION-INHERIT`
`textDirection: ltr`	`CL_WD_CHECKBOX=>E_TEXT_DIRECTION-LTR`
`textDirection: rtl`	`CL_WD_CHECKBOX=>E_TEXT_DIRECTION-RTL`
textWrapping	`TEXT_WRAPPING`	`WDY_BOOLEAN`
tooltip	`TOOLTIP`	`WDY_MD_TRANSLATABLE_TEXT`
visible	`VISIBLE`	`WDUI_VISIBILITY`
`visible: none`	`CL_WD_CHECKBOX=>E_VISIBLE-NONE`
`visible: visible`	`CL_WD_CHECKBOX=>E_VISIBLE-VISIBLE`

Dynamische Programmierung der Ereignisse
View Designer Name	Laufzeitname
onToggle	`ON_TOGGLE`

Beispiel

Test-Beispiele 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 Checkbox.