ItemListBox (SAP Library - Keyboard Access for Web Dynpro for ABAP / for Java)

ItemListBox

This UI element is similar to the classical GUI concept of a selection list with simple and multiple selection (list box). A list of text entries is displayed in a box of a fixed size, which if necessary you can scroll through. One or two columns are displayed for the values and possibly one column for symbols is displayed before the value column(s).

In the case of a simple selection the selected entry is determined by the lead selection of the dataSource. If the user changes the selection the property selectionChangeBehaviour is adhered to. With multiple selection the selected entries are determined by the dataSource selection only; selectionChangeBehaviour is not considered.

Note

To enable the development of Structure link accessibleapplications the property label is checked during the syntax check.

If no label has been set, and no descriptive text has been specified for the appropriate bound context element in the ABAP Dictionary, the property tooltip is checked.

Example of the Visual Display

This graphic is explained in the accompanying text

Runtime Class

CL_WD_ITEM_LIST_BOX

Properties in View Designer

Name	Type	Initial Value	Bindable
ID	STRING	(automatic)	No
dataSource	Context Node		Mandatory
descriptiveText	Translatable text		Yes
descriptiveTextDirection	WDUI_TEXT_DIRECTION	inherit	Yes
enabled	WDY_BOOLEAN	true	Yes
explanation	Translatable text		No
iconSource	STRING		Yes
multipleSelection	WDY_BOOLEAN	false	Yes
readOnly	WDY_BOOLEAN	false	Yes
selectionChangeBehaviour	WDUI_LEAD_SEL_CHNG_BEHVR	auto	No
text	Translatable text		Yes
textDirection	WDUI_TEXT_DIRECTION	inherit	Yes
tooltip	Translatable text		Yes
visible	WDUI_VISIBILITY	visible	Yes
visibleItems	I	10	Yes
width	STRING		Yes

Events in View Designer

Name

Structure link onLeadSelect

Note

Other properties that can be inherited are defined in the associated higher-level classes. The associated UI elements are:

● Structure link UIElement

● Structure link ViewElement

Dynamic Programming

For dynamic programming, the same properties, events and aggregations are available as in the View Designer. Bear in mind the different spellings.

Dynamic Programming of Properties

View Designer Name	Runtime Name	Type
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
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

Dynamic Programming of Events

View Designer Name	Runtime Name
onLeadSelect	ON_LEAD_SELECT

Example

You can find examples in the system in the Web Dynpro application, WDR_TEST_UI_ELEMENTS.