ItemListBox

Verwendung

Dieses Oberflächenelement ähnelt dem klassischen GUI-Konzept einer Auswahlliste mit Einfach-und Mehrfachselektion (Listbox). Es wird eine Liste von Texteinträgen in einem Kasten von fester Größe angezeigt, wobei bei Bedarf auch geblättert werden kann. Für die Werte werden eine oder zwei Spalten angezeigt und eventuell auch eine Spalte für Symbole, die vor der Wertespalte aufgeführt werden.

Im Fall der Einfachauswahl wird der gewählte Eintrag durch die Lead-Selection der dataSource bestimmt. Beim Ändern der Selektion durch den Benutzer wird die Eigenschaft selectionChangeBehaviour beachtet. Bei der Mehrfachauswahl werden die gewählten Einträge nur durch die Selektion der dataSource bestimmt, selectionChangeBehaviour wird nicht beachtet.

Beispiel für ItemListBox mit Label

Implementierungsdetails

Laufzeit-Klasse

CL_WD_ITEM_LIST_BOX

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
dataSource	Context-Knoten		muss
descriptiveText	Übersetzbarer Text		ja
descriptiveTextDirection	WDUI_TEXT_DIRECTION	inherit	ja
enabled	WDY_BOOLEAN	true	ja
explanation	Übersetzbarer Text		nein
iconSource	STRING		ja
multipleSelection	WDY_BOOLEAN	false	ja
readOnly	WDY_BOOLEAN	false	ja
selectionChangeBehaviour	WDUI_LEAD_SEL_CHNG_BEHVR	auto	nein
styleClassName	STRING		ja
text	Übersetzbarer Text		ja
textDirection	WDUI_TEXT_DIRECTION	inherit	ja
tooltip	Übersetzbarer Text		ja
visible	WDUI_VISIBILITY	visible	ja
visibleItems	I	10	ja
width	STRING		ja

Name	Kardinalität	Typ
DRAG_SOURCE_INFO	0..1	DragSourceInfo
DROP_TARGET_INFO	0..1	DropTargetInfo

Name
onDrop
onLeadSelect

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

Barrierefreiheit

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.

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.

View Designer Name	Laufzeitname	Typ
activateAccessKey	ACTIVATE_ACCESS_KEY	WDY_BOOLEAN
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_ITEM_LIST_BOX=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_ITEM_LIST_BOX=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_ITEM_LIST_BOX=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
dataSource	DATA_SOURCE	OBJECT
descriptiveText	DESCR_TEXT	WDY_MD_TRANSLATABLE_TEXT
descriptiveTextDirection	DESCR_TEXT_DIRECTION	WDUI_TEXT_DIRECTION
descriptiveTextDirection: inherit	CL_WD_ITEM_LIST_BOX=>E_DESCR_TEXT_DIRECTION-INHERIT
descriptiveTextDirection: ltr	CL_WD_ITEM_LIST_BOX=>E_DESCR_TEXT_DIRECTION-LTR
descriptiveTextDirection: rtl	CL_WD_ITEM_LIST_BOX=>E_DESCR_TEXT_DIRECTION-RTL
enabled	ENABLED	WDY_BOOLEAN
explanation	EXPLANATION	WDY_MD_TRANSLATABLE_TEXT
iconSource	ICON_SOURCE	STRING
multipleSelection	MULTIPLE_SELECTION	WDY_BOOLEAN
readOnly	READ_ONLY	WDY_BOOLEAN
selectionChangeBehaviour	SELECTION_CHANGE_BEHAVIOUR	WDUI_LEAD_SEL_CHNG_BEHVR
selectionChangeBehaviour: auto	CL_WD_ITEM_LIST_BOX=>E_SELECTION_CHANGE_BEHAVIOUR-AUTO
selectionChangeBehaviour: manual	CL_WD_ITEM_LIST_BOX=>E_SELECTION_CHANGE_BEHAVIOUR-MANUAL
styleClassName	STYLE_CLASS_NAME	STRING
text	TEXT	WDY_MD_TRANSLATABLE_TEXT
textDirection	TEXT_DIRECTION	WDUI_TEXT_DIRECTION
textDirection: inherit	CL_WD_ITEM_LIST_BOX=>E_TEXT_DIRECTION-INHERIT
textDirection: ltr	CL_WD_ITEM_LIST_BOX=>E_TEXT_DIRECTION-LTR
textDirection: rtl	CL_WD_ITEM_LIST_BOX=>E_TEXT_DIRECTION-RTL
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_ITEM_LIST_BOX=>E_VISIBLE-NONE
visible: visible	CL_WD_ITEM_LIST_BOX=>E_VISIBLE-VISIBLE
visibleItems	VISIBLE_ITEMS	I
width	WIDTH	STRING

View Designer Name	Laufzeitname
onDrop	ON_DROP
onLeadSelect	ON_LEAD_SELECT

View Designer Name	Laufzeitname	Kardinalität
DRAG_SOURCE_INFO	DRAG_SOURCE_INFO	0..1
DROP_TARGET_INFO	DROP_TARGET_INFO	0..1

Beispiel

Ein Test-Beispiel für dieses Oberflächenelement finden Sie im System in der Web-Dynpro-Applikation WDR_TEST_UI_ELEMENTS.