AbstractDropDownListBox Properties

Use

  • deselectable

    If this value is 'true', the dropdown list obtains an additional empty entry in the first position.

    If you select this entry, the lead selection of the itemDataSource node is reset. In this case, the index parameter of the onSelect event is IF_WD_CONTEXT_NODE=>NO_SELECTION.

  • design

    How the UI element is displayed. This property can be personalized by administrators.

    Value

    Example of the Visual Display

    Can be Set Using Personalization

    monospace

    Yes

    standard

    Yes

  • itemDataSource

    Context node for dropdown menu

  • itemDescription

    Example of the Visual Display

    Description

    The dropdown menu consists of two columns. itemDescription is the description column, which is displayed in a different color. The first column contains the list entries.

    The description column is available as soon as there is at least one description value.

  • itemDesign

    How the list items are displayed in the dropdown menu. For example, the font can be changed.

  • itemEnabled

    Example of the Visual Display

    Description

    If the value of items in the selection list is itemEnabled=true, they cannot be selected and are highlighted.

  • itemImageSource

    Example of the Visual Display

    Description

    Symbol in front of the list entry in the dropdown menu. The column appears in front of the list entries column as soon as there is a symbol for at least one entry.

  • itemKey

    Example of the Visual Display

    Description

    The keys are generally not visible, but can be made visible by binding the itemDescription property to the context attribute of the itemKey property. They are then listed in the dropdown menu in a separate column with a different color next to the list entries, replacing the itemDescription.

  • itemSemanticColor

    Example of the Visual Display

    Description

    Colors can be assigned to single list items.

  • itemText

    actual, selectable value

    This column of list entries is always available, which means the itemText binding is obligatory.

  • itemTooltip

    Example of the Visual Display

    Description

    A tooltip can be assigned to each item in the dropdown menu, which appears as soon as the user moves the mouse pointer over an item (see the example item blackberry in the figure).

  • selectedKey

    itemKey of the selected value from the value set in the dropdown list.

    You can find an example in the system under WDR_TEST_DDLB.

    Primary Property

    Both users and administrators can personalize, configure, and maintain this property. This means you can also predefine values for it. You can only predefine values if no action is defined for the UI element. An action always leads to a roundtrip, which could result in the view being rebuilt. The framework does not map these roundtrips when the screen is first built.

    For more information, see Methods and Properties of UI Elements.