DropDownByIndex 

Ein DropDownByIndex-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 man die Drucktaste betätigt.

Beispiel für die Verwendung

Wenn Sie eine Table mit Dropdown-Listen erstellen möchten, wobei jede Table-Zeile unterschiedliche Werte in ihrer Dropdown-Liste haben kann, verwenden Sie DropDownByIndex.

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.

Die angezeigten Texte werden aus dem Attribut texts gezogen, welches an einem Knoten mit Kardinalität 0..n oder 1..n hängt.

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 Index-Datenbindung erhalten Sie unter AbstractDropDownByIndex.

 

Laufzeit-Klasse

CL_WD_DROPDOWN_BY_IDX

 

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
deselectable	WDY_BOOLEAN	false	nein
enabled	WDY_BOOLEAN	true	ja
explanation	Übersetzbarer Text		nein
labelFor	WDY_MD_UI_ELEMENT_REFERENCE		nein
readOnly	WDY_BOOLEAN	false	ja
selectionChangeBehaviour	WDUI_LEAD_SEL_CHNG_BEHVR	auto	nein
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

onSelect

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

·         AbstractDropDownByIndex

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

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_IDX=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_DROPDOWN_BY_IDX=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_DROPDOWN_BY_IDX=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
deselectable	DESELECTABLE	WDY_BOOLEAN
enabled	ENABLED	WDY_BOOLEAN
explanation	EXPLANATION	WDY_MD_TRANSLATABLE_TEXT
labelFor	LABEL_FOR	WDY_MD_UI_ELEMENT_REFERENCE
readOnly	READ_ONLY	WDY_BOOLEAN
selectionChangeBehaviour	SELECTION_CHANGE_BEHAVIOUR	WDUI_LEAD_SEL_CHNG_BEHVR
selectionChangeBehaviour: auto	CL_WD_DROPDOWN_BY_IDX=>E_SELECTION_CHANGE_BEHAVIOUR-AUTO
selectionChangeBehaviour: manual	CL_WD_DROPDOWN_BY_IDX=>E_SELECTION_CHANGE_BEHAVIOUR-MANUAL
state	STATE	WDUI_STATE
state: normal	CL_WD_DROPDOWN_BY_IDX=>E_STATE-NORMAL
state: required	CL_WD_DROPDOWN_BY_IDX=>E_STATE-REQUIRED
texts	TEXTS	WDY_MD_TRANSLATABLE_TEXT
textDirection	TEXT_DIRECTION	WDUI_TEXT_DIRECTION
textDirection: inherit	CL_WD_DROPDOWN_BY_IDX=>E_TEXT_DIRECTION-INHERIT
textDirection: ltr	CL_WD_DROPDOWN_BY_IDX=>E_TEXT_DIRECTION-LTR
textDirection: rtl	CL_WD_DROPDOWN_BY_IDX=>E_TEXT_DIRECTION-RTL
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_DROPDOWN_BY_IDX=>E_VISIBLE-NONE
visible: visible	CL_WD_DROPDOWN_BY_IDX=>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_idx.