DropDownByIndex

Use

A DropDownByIndex offers the user a dropdown list box. You cannot select more than one entry from the selection list. The UI element consists of a text field, a button, and a selection list. Any list item already selected is displayed in the text field. When the user presses the pushbutton, a list of possible values appears.

Example of Usage

If you want to create a table with dropdown lists, where each table row can have different values in its dropdown list, use DropDownByIndex.

Examples of the Display

The two dropdown list box UI elements DropDownByIndex und DropDownByKey do not differ from each other when displayed on the screen. However, the data binding model for the DropDownByKey UI element has a completely different concept.

The displayed texts are taken from the texts attribute, which is attached to a node with cardinality 0..n or 1..n.

See Data Binding within Web Dynpro generally and Data Binding of UI Element Properties, and Data Binding a Dropdown List Box. For more information about using dropdown list boxes with index data binding, see AbstractDropDownByIndex.

Runtime Class

CL_WD_DROPDOWN_BY_IDX

Properties in View Designer

Name	Type	Initial Value	Bindable
id	STRING	(automatic)	No
activateAccessKey	WDY_BOOLEAN	false	No
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	No
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		No
deselectable	WDY_BOOLEAN	false	No
displayAsText	WDY_BOOLEAN	false	Yes
displayOnly	WDY_BOOLEAN	false	Yes
enabled	WDY_BOOLEAN	true	Yes
explanation	Translatable text		No
imageSource	STRING		Yes
inputPrompt	Translatable text		Yes
labelFor	WDY_MD_UI_ELEMENT_REFERENCE		No
readOnly	WDY_BOOLEAN	false	Yes
selectionChangeBehaviour	WDUI_LEAD_SEL_CHNG_BEHVR	auto	No
state	WDUI_STATE	normal	Yes
styleClassName	STRING		Yes
texts	Translatable text		Mandatory
textDirection	WDUI_TEXT_DIRECTION	inherit	Yes
tooltip	Translatable text		Yes
visible	WDUI_VISIBILITY	visible	Yes
width	STRING		Yes

Events in View Designer

Name
onSelect

Dynamic Programming

For dynamic programming, the same properties, events, and aggregations as in the View Designer are available. But note that the spelling format and use of upper/lower case is different.

Dynamic Programming of Properties

View Designer Name	Runtime Name	Type
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
displayAsText	DISPLAY_AS_TEXT	WDY_BOOLEAN
displayOnly	DISPLAY_ONLY	WDY_BOOLEAN
enabled	ENABLED	WDY_BOOLEAN
explanation	EXPLANATION	WDY_MD_TRANSLATABLE_TEXT
imageSource	IMAGE_SOURCE	STRING
inputPrompt	INPUT_PROMPT	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
styleClassName	STYLE_CLASS_NAME	STRING
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

Dynamic Programming of Events

View Designer Name	Runtime Name
onSelect	ON_SELECT

Example

There is a system example for this UI element in the DEMO_UIEL_STD_SELECTION component in application demo_uiel_dropdown_by_idx.