ItemListBox Properties 

Properties in the View Designer

●      activateAccessKey

Activation of access keys.

This property can be personalized both by a user and by an administrator.

●      dataSource

Specifies the path to the context node which stores the categories and texts of the list box 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, the text and descriptiveText properties, must be bound to attributes within the dataSource.

●      descriptiveText

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

●      descriptiveTextDirection

Text or writing 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 an administrator.

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 that is displayed when the help mode is activated.
See Help Texts in and for Web Dynpro Applications

This property can be personalized by an administrator.

●      iconSource

Symbolic name of the symbol to be displayed.
See also 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 the entries in the ItemListBox, or whether it only is to be displayed as read-only. If they can only be displayed, existing selections are still displayed.

This property can be personalized by an administrator. 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 single 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 cannot set the lead selection in the event handler of onSelect.

●      text

Path to the context attribute that stores the short texts for the 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 an administrator.

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 an administrator.

●      width

Width of the UI element. More information: Methods and Properties of UI Elements.

This property can be personalized by an administrator.