DropDownListBox
You can use a DropDownListBox UI element to implement a dropdown menu. You can select one item only from this dropdown menu. The UI element consists of a text field, a button, and a selection list. When the user chooses the pushbutton, a list of possible values is displayed. If an item in the list is already selected, it is displayed in the text field.
The DropDownListBox combines the functions of the two UI elements DropDownByKey and DropDownByIndex by using property itemDataSource for data binding and index binding and property selectedKey for key binding. There is no difference in the appearance of the two dropdown UI elements (see figure below):
For more information, see Data Binding Using Index and Key.
Runtime Class |
CL_WD_DROP_DOWN_LIST_BOX |
Properties in View Designer
Name |
Type |
Initial Value |
Bindable |
|---|---|---|---|
STRING |
(automatic) |
No |
|
WDY_BOOLEAN |
false |
No |
|
WDUI_CONTEXT_MENU_BEHAVIOUR |
inherit |
No |
|
WDY_MD_UI_ELEMENT_REFERENCE |
No |
||
WDY_BOOLEAN |
false |
No |
|
WDUI_DROP_DOWN_DESIGN |
standard |
Yes |
|
WDY_BOOLEAN |
false |
Yes |
|
WDY_BOOLEAN |
false |
Yes |
|
WDY_BOOLEAN |
true |
Yes |
|
Translatable text |
|
No |
|
Translatable text |
|
Yes |
|
Context Node |
Mandatory |
||
Translatable text |
Yes |
||
WDUI_DROP_DOWN_DESIGN |
standard |
Yes |
|
WDY_BOOLEAN |
true |
Yes |
|
STRING |
Yes |
||
STRING |
Mandatory |
||
WDUI_TABLE_ITEM_SEMANTIC_COLOR |
standard |
Yes |
|
Translatable text |
Mandatory |
||
Translatable text |
Yes |
||
WDY_MD_UI_ELEMENT_REFERENCE |
|
No |
|
WDY_BOOLEAN |
false |
Yes |
|
STRING |
Mandatory |
||
WDUI_STATE |
normal |
Yes |
|
| styleClassName | STRING | Yes | |
WDUI_TEXT_DIRECTION |
inherit |
Yes |
|
Translatable text |
|
Yes |
|
WDUI_VISIBILITY |
visible |
Yes |
|
STRING |
|
Yes |
Events in View Designer
Name |
|---|
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 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 |
|---|---|---|
ACTIVATE_ACCESS_KEY |
WDY_BOOLEAN |
|
CONTEXT_MENU_BEHAVIOUR |
WDUI_CONTEXT_MENU_BEHAVIOUR |
|
contextMenuBehaviour: inherit |
CL_WD_DROP_DOWN_LIST_BOX=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT |
|
contextMenuBehaviour: provide |
CL_WD_DROP_DOWN_LIST_BOX=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE |
|
contextMenuBehaviour: suppress |
CL_WD_DROP_DOWN_LIST_BOX=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS |
|
CONTEXT_MENU_ID |
WDY_MD_UI_ELEMENT_REFERENCE |
|
DESELECTABLE |
WDY_BOOLEAN |
|
DESIGN |
WDUI_DROP_DOWN_DESIGN |
|
design: monospace |
CL_WD_DROP_DOWN_LIST_BOX=>E_DESIGN-MONOSPACE |
|
design: standard |
CL_WD_DROP_DOWN_LIST_BOX=>E_DESIGN-STANDARD |
|
DISPLAY_AS_TEXT |
WDY_BOOLEAN |
|
DISPLAY_ONLY |
WDY_BOOLEAN |
|
ENABLED |
WDY_BOOLEAN |
|
EXPLANATION |
WDY_MD_TRANSLATABLE_TEXT |
|
INPUT_PROMPT |
WDY_MD_TRANSLATABLE_TEXT |
|
ITEM_DATA_SOURCE |
OBJECT |
|
ITEM_DESCRIPTION |
WDY_MD_TRANSLATABLE_TEXT |
|
ITEM_DESIGN |
WDUI_DROP_DOWN_DESIGN |
|
itemDesign: monospace |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_DESIGN-MONOSPACE |
|
itemDesign: standard |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_DESIGN-STANDARD |
|
ITEM_ENABLED |
WDY_BOOLEAN |
|
ITEM_IMAGE_SOURCE |
STRING |
|
ITEM_KEY |
STRING |
|
ITEM_SEMANTIC_COLOR |
WDUI_TABLE_ITEM_SEMANTIC_COLOR |
|
itemSemanticColor: alternating |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-ALTERNATING |
|
itemSemanticColor: badvalue_dark |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-BADVALUE_DARK |
|
itemSemanticColor: badvalue_light |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-ALTERNATING |
|
itemSemanticColor: badvalue_medium |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-BADVALUE_MEDIUM |
|
itemSemanticColor: calendarAqua |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_AQUA |
|
itemSemanticColor: calendarBlue |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_BLUE |
|
itemSemanticColor: calendarBrown |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_BROWN |
|
itemSemanticColor: calendarGreen |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_GREEN |
|
itemSemanticColor: calendarMetal |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_METAL |
|
itemSemanticColor: calendarPeach |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_PEACH |
|
itemSemanticColor: calendarPurple |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_PURPLE |
|
itemSemanticColor: calendarRose |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_ROSE |
|
itemSemanticColor: calendarStandard |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_STANDARD |
|
itemSemanticColor: calendarTeal |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_TEAL |
|
itemSemanticColor: calendarYellow |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CALENDAR_YELLOW |
|
itemSemanticColor: color_aqua |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_AQUA |
|
itemSemanticColor: color_black |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_BLACK |
|
itemSemanticColor: color_blue |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_BLUE |
|
itemSemanticColor: color_blue_gray |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_BLUE_GRAY |
|
itemSemanticColor: color_bright_green |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_BRIGHT_GREEN |
|
itemSemanticColor: color_brown |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_BROWN |
|
itemSemanticColor: color_dark_blue |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_DARK_BLUE |
|
itemSemanticColor: color_dark_green |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_DARK_GREEN |
|
itemSemanticColor: color_dark_red |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_DARK_RED |
|
itemSemanticColor: color_dark_teal |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_DARK_TEAL |
|
itemSemanticColor: color_dark_yellow |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_DARK_YELLOW |
|
itemSemanticColor: color_gold |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_GOLD |
|
itemSemanticColor: color_gray_25 |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_GRAY_25 |
|
itemSemanticColor: color_gray_40 |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_GRAY_40 |
|
itemSemanticColor: color_gray_50 |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_GRAY_50 |
|
itemSemanticColor: color_gray_80 |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_GRAY_80 |
|
itemSemanticColor: color_green |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_GREEN |
|
itemSemanticColor: color_indigo |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_INDIGO |
|
itemSemanticColor: color_lavender |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_LAVENDER |
|
itemSemanticColor: color_light_blue |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_LIGHT_BLUE |
|
itemSemanticColor: color_light_green |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_LIGHT_GREEN |
|
itemSemanticColor: color_light_orange |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_LIGHT_ORANGE |
|
itemSemanticColor: color_light_turquoise |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_LIGHT_TURQUOISE |
|
itemSemanticColor: color_light_yellow |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_LIGHT_YELLOW |
|
itemSemanticColor: color_lime |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_LIME |
|
itemSemanticColor: color_olive_green |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_OLIVE_GREEN |
|
itemSemanticColor: color_orange |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_ORANGE |
|
itemSemanticColor: color_pale_blue |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_PALE_BLUE |
|
itemSemanticColor: color_pink |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_PINK |
|
itemSemanticColor: color_plum |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_PLUM |
|
itemSemanticColor: color_red |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_RED |
|
itemSemanticColor: color_rose |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_ROSE |
|
itemSemanticColor: color_sea_green |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_SEA_GREEN |
|
itemSemanticColor: color_sky_blue |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_SKY_BLUE |
|
itemSemanticColor: color_tan |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_TAN |
|
itemSemanticColor: color_teal |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_TEAL |
|
itemSemanticColor: color_turqoise |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_TURQUOISE |
|
itemSemanticColor: color_violet |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_VIOLET |
|
itemSemanticColor: color_white |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_WHITE |
|
itemSemanticColor: color_yellow |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-COLOR_YELLOW |
|
itemSemanticColor: critical |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CRITICAL |
|
itemSemanticColor: criticalvalue_dark |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CRITICALVALUE_DARK |
|
itemSemanticColor: criticalvalue_light |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CRITICALVALUE_LIGHT |
|
itemSemanticColor: criticalvalue_medium |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-CRITICALVALUE_MEDIUM |
|
itemSemanticColor: disabled |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-DISABLED |
|
itemSemanticColor: filter |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-FILTER |
|
itemSemanticColor: filtericon |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-FILTERICON |
|
itemSemanticColor: five |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-FIVE |
|
itemSemanticColor: four |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-FOUR |
|
itemSemanticColor: goodvalue_dark |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-GOODVALUE_DARK |
|
itemSemanticColor: goodvalue_light |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-GOODVALUE_LIGHT |
|
itemSemanticColor: goodvalue_medium |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-GOODVALUE_MEDIUM |
|
itemSemanticColor: group_highlighted |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-GROUP_HIGHLIGHTED |
|
itemSemanticColor: group_highlighted_light |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-GROUP_HIGHLIGHTED_LIGHT |
|
itemSemanticColor: group_level1 |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-GROUP_LEVEL1 |
|
itemSemanticColor: group_level2 |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-GROUP_LEVEL2 |
|
itemSemanticColor: group_level3 |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-GROUP_LEVEL3 |
|
itemSemanticColor: intensified |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-INTENSIFIED |
|
itemSemanticColor: key_medium |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-KEY_MEDIUM |
|
itemSemanticColor: marked |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-MARKED |
|
itemSemanticColor: negative |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-NEGATIVE |
|
itemSemanticColor: none |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-NONE |
|
itemSemanticColor: one |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-ONE |
|
itemSemanticColor: popin |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-POPIN |
|
itemSemanticColor: positive |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-POSITIVE |
|
itemSemanticColor: Selection |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-SELECTION |
|
itemSemanticColor: standard |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-STANDARD |
|
itemSemanticColor: subtotal |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-SUBTOTAL |
|
itemSemanticColor: subtotal_light |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-SUBTOTAL_LIGHT |
|
itemSemanticColor: three |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-THREE |
|
itemSemanticColor: today |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-TODAY |
|
itemSemanticColor: total |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-TOTAL |
|
itemSemanticColor: two |
CL_WD_DROP_DOWN_LIST_BOX=>E_ITEM_SEMANTIC_COLOR-TWO |
|
ITEM_TEXT |
WDY_MD_TRANSLATABLE_TEXT |
|
ITEM_TOOLTIP |
WDY_MD_TRANSLATABLE_TEXT |
|
LABEL_FOR |
WDY_MD_UI_ELEMENT_REFERENCE |
|
READ_ONLY |
WDY_BOOLEAN |
|
SELECTED_KEY |
STRING |
|
STATE |
WDUI_STATE |
|
state: normal |
CL_WD_DROP_DOWN_LIST_BOX=>E_STATE-NORMAL |
|
state: required |
CL_WD_DROP_DOWN_LIST_BOX=>E_STATE-REQUIRED |
|
| styleClassName | STYLE_CLASS_NAME | STRING |
TEXT_DIRECTION |
WDUI_TEXT_DIRECTION |
|
textDirection inherit |
CL_WD_DROP_DOWN_LIST_BOX=>E_TEXT_DIRECTION-INHERIT |
|
textDirection ltr |
CL_WD_DROP_DOWN_LIST_BOX=>E_TEXT_DIRECTION-LTR |
|
textDirection rtl |
CL_WD_DROP_DOWN_LIST_BOX=>E_TEXT_DIRECTION-RTL |
|
TOOLTIP |
WDY_MD_TRANSLATABLE_TEXT |
|
VISIBLE |
WDUI_VISIBILITY |
|
visible: none |
CL_WD_DROP_DOWN_LIST_BOX=>E_VISIBLE-NONE |
|
visible: visible |
CL_WD_DROP_DOWN_LIST_BOX=>E_VISIBLE-VISIBLE |
|
WIDTH |
STRING |
For more information, see: