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 |
|
WDY_BOOLEAN |
false |
No |
|
|
WDUI_CONTEXT_MENU_BEHAVIOUR |
inherit |
No |
|
|
WDY_MD_UI_ELEMENT_REFERENCE |
No |
||
|
WDY_BOOLEAN |
false |
Yes |
|
|
WDY_BOOLEAN |
true |
Yes |
|
|
Translatable text |
No |
||
|
WDY_BOOLEAN |
false |
Yes |
|
|
WDY_MD_UI_ELEMENT_REFERENCE |
No |
||
|
WDY_BOOLEAN |
false |
Yes |
|
|
STRING |
Mandatory |
||
|
WDUI_STATE |
normal |
Yes |
|
|
WDUI_TEXT_DIRECTION |
inherit |
Yes |
|
|
Translatable text |
Yes |
||
|
WDUI_VISIBILITY |
visible |
Yes |
|
|
STRING |
Yes |
Events in View Designer
|
Name |
|---|
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 |
|---|---|---|
|
ACTIVATE_ACCESS_KEY |
WDY_BOOLEAN |
|
|
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 |
|
|
CONTEXT_MENU_ID |
WDY_MD_UI_ELEMENT_REFERENCE |
|
|
DISPLAY_AS_TEXT |
WDY_BOOLEA |
|
|
ENABLED |
WDY_BOOLEA |
|
|
EXPLANATION |
WDY_MD_TRANSLATABLE_TEXT |
|
|
KEY_VISIBLE |
WDY_BOOLEAN |
|
|
LABEL_FOR |
WDY_MD_UI_ELEMENT_REFERENCE |
|
|
READ_ONLY |
WDY_BOOLEAN |
|
|
SELECTED_KEY |
STRING |
|
|
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 |
|
|
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 |
WDY_MD_TRANSLATABLE_TEXT |
|
|
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 |
STRING |
Dynamic Programming of Events
|
View Designer Name |
Runtime Name |
|---|---|
|
ON_SELECT |