DropDownByKey 

Ein DropDownByKey-Oberflächenelement bietet dem Benutzer eine Dropdown-Listbox an. Aus der Auswahlliste können Sie höchstens einen Eintrag auswählen. Das Oberflächenelement 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.

Wenn Sie eine DropDown-Liste erstellen möchten, in der manche Einträge mehrfach vorhanden sind, verwenden Sie DropDownByKey.

Um die Entwicklung barrierefreier Anwendungen zu ermöglichen, wird im Rahmen des Syntaxchecks die Eigenschaft label überprüft.

Wenn kein label gesetzt wurde und auch für das entsprechende gebundene Context-Element im ABAP-Dictionary kein Beschreibungstext angegeben wurde, findet eine Überprüfung auf die Eigenschaft tooltip statt.

Beispiele für die visuelle Darstellung

In der Darstellung am Bildschirm unterscheiden sich die beiden Dropdown-Listbox-Oberflächenelemente DropDownByIndex und DropDownByKey nicht. Jedoch verfolgt das Datenbindungsmodell für das DropDownByKey-Oberflächenelement ein völlig anderes Konzept. Siehe Datenbindung innerhalb Web Dynpro allgemein und Datenbindung von Oberflächenelement-Eigenschaften sowie Datenbindung einer Dropdown-Listbox. Zusätzliche Informationen zur Verwendung der Dropdown-Listbox mittels Schlüssel-Datenbindung erhalten Sie unter AbstractDropDownByKey.

 

Laufzeit-Klasse

CL_WD_DROPDOWN_BY_KEY

 

Eigenschaften im View Designer

Name	Typ	Anfangswert	Bindbar
id	STRING	(automatisch)	nein
enabled	WDY_BOOLEAN	true	ja
explanation	Übersetzbarer Text		nein
keyVisible	WDY_BOOLEAN	false	ja
labelFor	STRING		nein
readOnly	WDY_BOOLEAN	false	ja
selectedKey	STRING		muss
state	WDUI_STATE	normal	ja
textDirection	WDUI_TEXT_DIRECTION	inherit	ja
tooltip	Übersetzbarer Text		ja
visible	WDUI_VISIBILITY	visible	ja
width	STRING		ja

 

Events im View Designer

Name

onSelect

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

●        AbstractDropDownByKey

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

Beachten Sie bei der dynamischen Programmierung von Wertelisten im Context (NODE_INFO->SET_ATTROBUTE_VALUE_SET() ), dass Sie bei der Verwendung von Integertypen für ein Attribut ein CONDENSE einbauen.

Dynamische Programmierung der Eigenschaften

View Designer Name	Laufzeitname	Typ
enabled	ENABLED	WDY_BOOLEAN
explanation	EXPLANATION	WDY_MD_TRANSLATABLE_TEXT
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_DROPDOWN_BY_KEY=>E_STATE-NORMAL
state: required	CL_WD_DROPDOWN_BY_KEY=>E_STATE-REQUIRED
textDirection	TEXT_DIRECTION	WDUI_TEXT_DIRECTION
textDirection: inherit	CL_WD_DROPDOWN_BY_KEY=>E_TEXT_DIRECTION-INHERIT
textDirection: ltr	CL_WD_DROPDOWN_BY_KEY=>E_TEXT_DIRECTION-LTR
textDirection: rtl	CL_WD_DROPDOWN_BY_KEY=>E_TEXT_DIRECTION-RTL
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_DROPDOWN_BY_KEY=>E_VISIBLE-NONE
visible: visible	CL_WD_DROPDOWN_BY_KEY=>E_VISIBLE-VISIBLE
width	WIDTH	STRING

 

Dynamische Programmierung der Ereignisse

View Designer Name	Laufzeitname
onSelect	ON_SELECT

Beispiel

Sie finden ein Beispiel für dieses UI-Element im System in der Component DEMO_UIEL_STD_SELECTION in der Applikation demo_uiel_dropdown_by_key.