AbstractDropDownByKey

Use

The AbstractDropDownBy UI element is the abstract base class of all dropdown list boxes that uses the Key Binding Model for data binding.

The dropdown list box offers a selection list to users from which they can select an entry. It consists of a text field, a pushbutton and a selection list. Any list item already selected is displayed in the text field. When the user chooses the pushbutton, a list of all possible values is displayed.

The set of values that can be selected results from the value set of the data type of the attribute to which the selectedKey property is bound. The description for the "value" is displayed.

Data Binding

The context provides the content to be displayed within the UI element, the associated keys, and the selected key.

The context must provide the node X that can contain 0 to n elements. (cardinality=0..n). The node must contain the attribute y, whose data type can contain a value set (set of value/description pairs). The keys of the dropdown list box are the values of this value set. The texts displayed in the selection list are the respective descriptions. The selected key is provided by the current value of the attribute y.

The selectedKey property of the DropDownByKey UI element is bound to the attribute y by assigning the path of the context X.y to the selectedKey property.

Implementation Details

Runtime Class

CL_WD_ABSTRACT_DROPDOWN_BY_KEY

Properties in View Designer

Name	Type	Initial Value	Bindable
i d	STRING	(automatic)	No
activateAccessKey	WDY_BOOLEAN	false	No
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	No
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		No
displayAsText	WDY_BOOLEAN	false	Yes
enabled	WDY_BOOLEAN	true	Yes
explanation	Translatable text		No
keyVisible	WDY_BOOLEAN	false	Yes
labelFor	WDY_MD_UI_ELEMENT_REFERENCE		No
readOnly	WDY_BOOLEAN	false	Yes
selectedKey	STRING		Mandatory
state	WDUI_STATE	normal	Yes
textDirection	WDUI_TEXT_DIRECTION	inherit	Yes
tooltip	Translatable text		Yes
visible	WDUI_VISIBILITY	visible	Yes
width	STRING		Yes

Events in View Designer

Name
onSelect

Note

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

Dynamic Programming

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

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_ABSTRACT_DROPDOWN_BY_IDX=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_ABSTRACT_DROPDOWN_BY_IDX=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_ABSTRACT_DROPDOWN_BY_IDX=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
displayAsText	DISPLAY_AS_TEXT	WDY_BOOLEA
enabled	ENABLED	WDY_BOOLEA
explanation	EXPLANATION	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_ABSTRACT_DROPDOWN_BY_IDX=>E_STATE-NORMAL
state: required	CL_WD_ABSTRACT_DROPDOWN_BY_IDX=>E_STATE-REQUIRED
textDirection	TEXT_DIRECTION	WDUI_TEXT_DIRECTION
textDirection inherit	CL_WD_ABSTRACT_DROPDOWN_BY_IDX=>E_TEXT_DIRECTION-INHERIT
textDirection ltr	CL_WD_ABSTRACT_DROPDOWN_BY_IDX=>E_TEXT_DIRECTION-LTR
textDirection rtl	CL_WD_ABSTRACT_DROPDOWN_BY_IDX=>E_TEXT_DIRECTION-RTL
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE WDUI_VISIBILITY
visible: none	CL_WD_ABSTRACT_DROPDOWN_BY_IDX=>E_VISIBLE-NONE
visible: visible	CL_WD_ABSTRACT_DROPDOWN_BY_IDX=>E_VISIBLE-VISIBLE
width	WIDTH	STRING

Dynamic Programming of Events

View Designer Name	Runtime Name
onSelect	ON_SELECT