CheckBoxGroup

Die CheckBoxGroup erlaubt dem Benutzer, ein Element aus einer Menge vorgegebener Alternativen durch Ankreuzen auszuwählen. Das Oberflächenelement CheckBoxGroup ordnet die einzelnen CheckBoxes ein- oder mehrspaltig in tabellarischer Form an.

Für die Darstellung einer angekreuzten CheckBox in einer CheckBoxGroup verwenden Sie für das dazugehörige Context-Element die Methode SET_SELECTED von IF_WD_CONTEXT_ELEMENT. Beachten Sie, dass die Selektion der CheckBoxen in einer CheckBoxGroup nicht über ein gebundenes Context-Attribut geschieht.

Beispiele für die visuelle Darstellung
Einspaltig	Zweispaltig	Dreispaltig
(CheckBoxGroup)	(CheckBoxGroup)	(CheckBoxGroup)

Barrierefreiheit

Um die Entwicklung barrierefreier Anwendungen zu ermöglichen, wird im Rahmen des Syntaxchecks die Eigenschaft accessibilityDescription überprüft, wenn die Eigenschaft tooltip nicht gesetzt wurde.

Datenbindung

Eine CheckBoxGroup repräsentiert eine mehrfache Auswahl (Multiple-Selection), die durch eine Gruppe von Checkboxes am Bildschirm angezeigt wird.

Der View-Context muss einen Knoten X zur Verfügung stellen, der 0 bis n Werte enthalten kann (Kardinalität=0..n). Der Context-Knoten muss ein Attribut y enthalten, das die Texte für die CheckBoxes liefert. Der Datentyp des Context-Attributs y kann jeder einfache Datentyp wie String, int, usw. sein. Die Anzahl der CheckBoxes entspricht der Anzahl der Knotenelemente. Die Auswahl der CheckBoxes wird durch die mehrfache Auswahl (Multiple-Selection) des Knotens bestimmt. Zur Datenbindung wird die Eigenschaft texts des CheckBoxGroup-Oberflächenelements mit dem Attribut y gebunden, indem der Eigenschaft texts der Context-Pfad des Contexts y zugeordnet wird.

Weitere Informationen über den Aufbau von Context-Strukturen finden Sie unter Context und über das Datanbindungsmodell unter Datenbindung und Mapping und Die Datenbindung sowie Datenbindung von Oberflächenelement-Eigenschaften.

Implementierungsdetails

Laufzeit-Klasse

CL_WD_CHECKBOX_GROUP

Eigenschaften im View Designer
Name	Typ	Anfangswert	Bindbar
id	`STRING`	(automatisch)	nein
accessibilityDescription	Übersetzbarer Text		ja
activateAccessKey	`WDY_BOOLEAN`	`false`	nein
colCount	`I`	1	ja
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
texts	Übersetzbarer Text		muss
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
width	`STRING`		ja

Events im View Designer
Name
onToggle

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.

Dynamische Programmierung der Eigenschaften
View Designer Name	Laufzeitname	Typ
accessibilityDescription	`ACCESSIBILITY_DESCR`	`WDY_MD_TRANSLATABLE_TEXT`
activateAccessKey	`ACTIVATE_ACCESS_KEY`	`WDY_BOOLEAN`
colCount	`COL_COUNT`	`I`
contextMenuBehaviour	`CONTEXT_MENU_BEHAVIOUR`	`WDUI_CONTEXT_MENU_BEHAVIOUR`
`contextMenuBehaviour: inherit`	`CL_WD_CHECKBOX_GROUP=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT`
`contextMenuBehaviour: provide`	`CL_WD_CHECKBOX_GROUP=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE`
`contextMenuBehaviour: suppress`	`CL_WD_CHECKBOX_GROUP=>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`
readOnly	`READ_ONLY`	`WDY_BOOLEAN`
state	`STATE`	`WDUI_STATE`
`state: normal`	`CL_WD_CHECKBOX_GROUP=>E_STATE-NORMAL`
`state: required`	`CL_WD_CHECKBOX_GROUP=>E_STATE-REQUIRED`
texts	`TEXTS`	`WDY_MD_TRANSLATABLE_TEXT`
textDesign	`TEXT_DESIGN`	`WDUI_CHECKBOX_TEXT_DESIGN`
`textDesign: emphasized`	`CL_WD_CHECKBOX_GROUP=>E_TEXT_DESIGN-EMPHASIZED`
`textDesign: standard`	`CL_WD_CHECKBOX_GROUP=>E_TEXT_DESIGN-STANDARD`
textDirection	`TEXT_DIRECTION`	`WDUI_TEXT_DIRECTION`
`textDirection: inherit`	`CL_WD_CHECKBOX_GROUP=>E_TEXT_DIRECTION-INHERIT`
`textDirection: ltr`	`CL_WD_CHECKBOX_GROUP=>E_TEXT_DIRECTION-LTR`
`textDirection: rtl`	`CL_WD_CHECKBOX_GROUP=>E_TEXT_DIRECTION-RTL`
textWrapping	`TEXT_WRAPPING`	`WDY_BOOLEAN`
tooltip	`TOOLTIP`	`WDY_MD_TRANSLATABLE_TEXT`
visible	`VISIBLE`	`WDUI_VISIBILITY`
`visible: none`	`CL_WD_CHECKBOX_GROUP=>E_VISIBLE-NONE`
`visible: visible`	`CL_WD_CHECKBOX_GROUP=>E_VISIBLE-VISIBLE`
width	`WIDTH`	`STRING`

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

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