Show TOC Anfang des Inhaltsbereichs

Hintergrunddokumentation CheckBoxGroup  Dokument im Navigationsbaum lokalisieren

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.

Hinweis

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.

Beispiele für die visuelle Darstellung

Einspaltig

Zweispaltig

Dreispaltig

Diese Grafik wird im zugehörigen Text erklärt

Diese Grafik wird im zugehörigen Text erklärt

Diese Grafik wird im zugehörigen Text erklärt

 

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

enabled

WDY_BOOLEAN

true

ja

readOnly

WDY_BOOLEAN

false

ja

state

WDUI_STATE

normal

ja

texts

Übersetzbarer Text

 

muss

textDirection

WDUI_TEXT_DIRECTION

inherit

ja

tooltip

Übersetzbarer Text

 

ja

visible

WDUI_VISIBILITY

visible

ja

width

STRING

 

ja

 

Events im View Designer

Name

onToggle

Hinweis

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

        UIElement

        ContextMenuProvider

        ViewElement

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

enabled

ENABLED

WDY_BOOLEAN

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

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

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

 

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.

Hinweis

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.

Beispiel

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

Ende des Inhaltsbereichs