CheckBoxGroup

Verwendung

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.

Einspaltig	Zweispaltig	Dreispaltig

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

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
styleClassName	STRING		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

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.

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
styleClassName	STYLE_CLASS_NAME	STRING
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

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.