Show TOC Anfang des Inhaltsbereichs

Hintergrunddokumentation AbstractDropDownByKey Dokument im Navigationsbaum lokalisieren

AbstractDropDownByKey stellt die abstrakte Basisklasse aller Dropdown-Listboxen dar, die zur Datenbindung das Schlüssel-Datenbindungsmodell verwendet.

Die Dropdow-Listbox bietet dem Benutzer eine Auswahlliste an, aus der er einen oder keinen Eintrag auswählen kann und besteht aus einem Textfeld, einer Drucktaste sowie einer Auswahlliste. Dabei wird ein bereits ausgewählter Listeneintrag im Textfeld dargestellt. Eine Liste aller möglichen Werte wird angezeigt, wenn die Drucktaste betätigt wird.

Die Menge der auswählbaren Werte ergibt sich aus der Wertemenge am Datentyp des Attributs, an das die Eigenschaft selectedKey gebunden ist. Dargestellt wird jeweils die zum „Wert“ gehörende Beschreibung.

Datenbindung

Der Inhalt, der innerhalb des Oberflächenelements angezeigt werden soll, die dazugehörigen Schlüssel sowie der ausgewählte Schlüssel werden durch den Context geliefert.

Der Context muss einen Knoten X zur Verfügung stellen, der 0 bis n Elemente enthalten kann. (Kardinalität=0..n). Der Knoten muss ein Attribut y enthalten, dessen Datentyp eine Wertemenge (Menge von Wert-Beschreibung-Paaren) aufnehmen kann. Die Schlüssel der Dropdown-Listbox sind die Werte dieser Wertemenge. Die Texte, die in der Auswahlliste angezeigt werden, sind die entsprechenden Beschreibungen. Der ausgewählte Schlüssel wird vom aktuellen Wert des Attributs y geliefert.

Zur Datenbindung wird die Eigenschaft selectedKey des DropDownByKey-Oberflächenelements mit dem Attribut y gebunden, indem der Eigenschaft selectedKey der Pfad des Contexts X.y zugeordnet wird.

 

Laufzeit-Klasse

CL_WD_ABSTRACT_DROPDOWN_BY_KEY

 

Eigenschaften im View Designer

Name

Typ

Anfangswert

Bindbar

id

STRING

(automatisch)

nein

enabled

WDY_BOOLEAN

true

ja

keyVisible

WDY_BOOLEAN

false

ja

readOnly

WDY_BOOLEAN

false

ja

selectedKey

STRING

 

muss

state

WDUI_STATE

normal

ja

textDirection

WDUI_TEXT_DIRECTION

inherit

ja

tooltip

Text

 

ja

visible

WDUI_VISIBILITY

visible

ja

width

STRING

 

ja

 

Events im View Designer

Name

onSelect

Hinweis

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

·         AbstractDropDown

·         UIElement

·         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

enabled

ENABLED

WDY_BOOLEAN

keyVisible

KEY_VISIBLE

WDY_BOOLEAN

labelFor

LABEL_FOR

STRING

readOnly

READ_ONLY

WDY_BOOLEAN

selectedKey

SELECTED_KEY

STRING

state

STATE

WDUI_STATE

 state: normal

CL_WD_ABSTRACT_DROPDOWN_BY_KEY=>E_STATE-NORMAL

 state: required

CL_WD_ABSTRACT_DROPDOWN_BY_KEY=>E_STATE-REQUIRED

textDirection

TEXT_DIRECTION

WDUI_TEXT_DIRECTION

 textDirection: inherit

CL_WD_ABSTRACT_DROPDOWN_BY_KEY=>E_TEXT_DIRECTION-INHERIT

 textDirection: ltr

CL_WD_ABSTRACT_DROPDOWN_BY_KEY=>E_TEXT_DIRECTION-LTR

 textDirection: rtl

CL_WD_ABSTRACT_DROPDOWN_BY_KEY=>E_TEXT_DIRECTION-RTL

tooltip

TOOLTIP

WDY_MD_TRANSLATABLE_TEXT

visible

VISIBLE

WDUI_VISIBILITY

 visible: none

CL_WD_ABSTRACT_DROPDOWN_BY_KEY=>E_VISIBLE-NONE

 visible: visible

CL_WD_ABSTRACT_DROPDOWN_BY_KEY=>E_VISIBLE-VISIBLE

width

WIDTH

STRING

 

Dynamische Programmierung der Ereignisse

View Designer Name

Laufzeitname

onSelect

ON_SELECT

 

Ende des Inhaltsbereichs