An ItemListbox provides different values for selection, similar to the DropDownBox. You can vary the number of displayed values and, in contrast to a DropDownBox, multiple selection is possible.
Indicates whether access key for this control is activated. More information: Enabling Access Keys
This property is used to specify the data source. You can use it to specify the path to the context node providing the data.
This property defines a descriptive text that is displayed within the ItemListBox beside the text.
determines the explanation text. More information: Explanation
defines the path to the image source.
More Information: Specifying the Image Source
This property specifies the text direction and allows you to use dropdown list boxes for texts in languages that require a specific text direction. The textDirection property can be filled with the following values and is represented by the listing type WDTextDirection.
inherit |
The text direction is inherited from the parent element. Therefore, the text direction is identical to the one of the parent element. |
ltr |
The text runs from left to right. |
rtl |
The text runs from right to left. |
The default value for this property is inherit.
This property enables the selection of several elements.
This property controls whether the user can choose an element from the ItemListBox UI element.
The change of the lead selection can cause a data loss - for example, if the changed or new data was not written to the context due to syntax errors. You can avoid the data loss using the selectionChangeBehaviour property before changing the lead selection:
|
|
|
|
This property specifies the text to be assigned to the ItemListBox .
You can use this property to define the text direction. It thus enables the labels for all item list boxes to be read in other languages that require a specific text direction. The textDirection property can be filled with the following values and is represented by the listing type WDTextDirection.
inherit |
The text direction is inherited from the parent element. Therefore, the text direction is identical to the one of the parent element. |
ltr |
The text runs from left to right. |
rtl |
The text runs from right to left. |
The default value for this property is inherit.
This property defines the size of the item list box on the basis of the number of visible elements.
This property specifies the width of the item list box and can be specified in CSS units like em, ex, pixels, or percentage.
Name |
Interface |
Type |
Initial Value |
Bindable |
activateAccessKey |
IWDItemListBox |
boolean |
false |
not bindable |
dataSource |
IWDItemListBox |
Object |
|
bindable_mandatory |
descriptiveText |
IWDItemListBox |
String |
|
bindable |
descriptiveTextDirection |
IWDItemListBox |
WDTextDirection |
inherit |
bindable |
enabled |
IWDUIElement |
boolean |
true |
bindable |
explanation |
IWDItemListBox |
String |
|
not_bindable |
iconSource |
IWDItemListBox |
String |
|
bindable |
multipleSelection |
IWDItemListBox |
boolean |
false |
bindable |
readOnly |
IWDItemListBox |
boolean |
false |
bindable |
selectionChangeBehaviour |
IWDItemListBox |
WDLeadSelectionChangeBehaviour |
auto |
not_bindable |
text |
IWDItemListBox |
String |
|
bindable |
textDirection |
IWDItemListBox |
WDTextDirection |
inherit |
bindable |
tooltip |
IWDUIElement |
String |
|
bindable |
visible |
IWDUIElement |
WDVisibility |
visible |
bindable |
visibleItems |
IWDItemListBox |
int |
10 |
bindable |
width |
IWDItemListBox |
String |
|
bindable |
This event is triggered when the user selects an element of the ItemListBox.
This event is triggered when the user drops an object onto this ItemListBox. The parameters are: