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 DropDownByIndex-Oberflächenelement ein völlig anderes Konzept. Die angezeigten Texte sind diejenigen der Werteliste (ValueSet) bzw. die ABAP-Dictionary-Domänenwerte des Attributs, an dem die Eigenschaft selectedKey gebunden ist.

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
activateAccessKey	WDY_BOOLEAN	false	nein
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
displayAsText	WDY_BOOLEAN	false	ja
displayOnly	WDY_BOOLEAN	false	ja
enabled	WDY_BOOLEAN	true	ja
explanation	Übersetzbarer Text		nein
inputPrompt	Übersetzbarer Text		ja
keyVisible	WDY_BOOLEAN	false	ja
labelFor	WDY_MD_UI_ELEMENT_REFERENCE		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

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

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
activateAccessKey	ACTIVATE_ACCESS_KEY	WDY_BOOLEAN
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_DROPDOWN_BY_KEY=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_DROPDOWN_BY_KEY=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_DROPDOWN_BY_KEY=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
displayAsText	DISPLAY_AS_TEXT	WDY_BOOLEAN
displayOnly	DISPLAY_ONLY	WDY_BOOLEAN
enabled	ENABLED	WDY_BOOLEAN
explanation	EXPLANATION	WDY_MD_TRANSLATABLE_TEXT
inputPrompt	INPUT_PROMPT	WDY_MD_TRANSLATABLE_TEXT
keyVisible	KEY_VISIBLE	WDY_BOOLEAN
labelFor	LABEL_FOR	WDY_MD_UI_ELEMENT_REFERENCE
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.