Show TOC

ItemListBox PropertiesLocate this document in the navigation structure

Use
  • activateAccessKey

    Activates access keys.

    Both users and administrators can personalize this property.

  • dataSource

    Specifies the path to the context node that stores the categories and texts of the ItemListBox entries. Each node element represents one entry in the ItemListBox. The ItemListBox entries are displayed in the order of the node elements.

    Properties that are to have a different value for each entry, for example, text and descriptiveText, must be bound to attributes within the dataSource.

  • descriptiveText

    Path to the context attribute that stores the descriptive texts for ItemListBox entries. This text is displayed next to the short text (property text).

  • descriptiveTextDirection

    Text or text direction of the descriptive text.

    This enables labels of interface elements to be read in languages that have an RTL writing direction, such as Arabic or Hebrew, as opposed to LTR for languages like English.

    This property can be personalized by administrators.

    Value

    Description

    Can Be Set Using Personalization

    INHERIT

    The text direction is inherited from the parent element. Therefore, the text direction is identical to that of the parent element.

    Yes

    LTR

    Left to right text direction

    Yes

    RTL

    Right to left text direction

    Yes

  • explanation

    Help text displayed when the help mode is activated. See also Help Texts in and for Web Dynpro Applications

    This property can be personalized by administrators.

Note

The explanation iproperty is only displayed if a Label exists for the corresponding UI element.

Note the following exception :

The explanation property of an AbstractTableColumn is always displayed. If the UI element appears in a Table, and therefore has no Label, then use a AbstractTableColumn.explanation as a replacement for an explanation for the respective UI element (for example, InputField).

  • iconSource

    Name of the symbol to be displayed.

    More information: Handling Web Icons

  • multipleSelection

    Determines whether a multiple selection within the entries in the ItemListBox is possible or not.

  • readOnly

    Specifies whether the user can select entries in the ItemListBox, or whether they are to be displayed as read-only. If they can only be displayed, existing selections are still displayed.

    This property can be personalized by administrators. In personalization, this property can be assigned the value: true

  • selectionChangeBehaviour

    Enables the application itself to change the lead selection.

    This function works only if multipleSelection=false.

    When you choose an entry in the ItemListBox with multiple selection the lead selection changes. Data may get lost if there is a singleton node beneath the lead selection.

    Value

    Description

    auto

    The lead selection changes automatically to the newly selected entry.

    manual

    The lead selection is not set by the framework. The application developer can set the lead selection in the event handler of onLeadSelect.

  • text

    Path to the context attribute that stores the short texts for ItemListBox entries. This text is displayed next to the descriptive text (property descriptiveText).

  • textDirection

    Text or writing direction.

    This enables labels of interface elements to be read in languages that have an RTL writing direction, such as Arabic or Hebrew, as opposed to LTR for languages like English.

    This property can be personalized by administrators.

    Value

    Description

    Can be Set Using Personalization

    INHERIT

    The text direction is inherited from the parent element. Therefore, the text direction is identical to that of the parent element.

    Yes

    LTR

    Left to right text direction

    Yes

    RTL

    Right to left text direction

    Yes

  • visibleItems

    Number of visible entries. If more entries than are visible exist, a scroll bar appears, with which you can scroll through the entries.

    This property can be personalized by administrators.

  • width

    Width of the UI element. See also Methods and Properties.

    This property can be personalized by administrators.