ToolBarDropDownByIndex API 

The ToolBarDropDownByIndex element is a dropdown box in a toolbar. Index Binding is used for data binding. For an example, refer to Code Examples of Data Binding.

Description of UI Element Properties

·        collapsible
Specifies whether the ToolBar element can be collapsed. A little icon is displayed in a ToolBar which contains those elements. When the user selects this icon, all toolbar elements with the collapsible property set to true are hidden.

·        labelFor
This property enables you to assign the ToolBarDropDownByIndex element to another UI element as a label.

·        labelText
Specifies the label text.

·        readOnly
Specifies whether the user can modify the selection in the toolbar dropdown list box.

·        selectionChangeBehaviour
The selectionChangeBehaviour property can be filled with the following values and is represented by the enumeration type WDLeadSelectionChangeBehaviour.

·        auto	·        Specifies that the UI element automatically changes the lead selection after an interaction by the user before the corresponding event is triggered.
·        manual	·        Specifies that the UI element does not change the lead selection after an interaction by the user but triggers the corresponding event. In this case, the event handler must change the lead selection to enable the UI element to display the data. This setting allows you to check the change of the lead selection.

·        state
Describes the status of the dropdown list box. The data type of this property corresponds to the enumeration type WDState. You can use the following values in the application:

normal	Describes the default state of the UI element.
required	Indicates that value selection is mandatory.

·        textDirection
Specifies the text direction and allows you to use dropdown list boxes for texts in languages which require a specific text direction. The textDirection property can be filled with the following values and is represented by the enumeration 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.

·        texts
Determines the content of the list entries.

·        width
Specifies the width of the dropdown list box and can be specified in CSS units like em, ex, pixels, or percentage.

Overview of Inherited and Additional Properties

Name	Interface	Type	Initial Value	Bindable	Value Required
collapsible	IWDToolBarDropDownByIndex	boolean	false	bindable	No
enabled	IWDUIElement	Boolean	true	bindable	No
labelFor	IWDAbstractDropDown	String		not_bindable	No
labelText	IWDToolBarDropDownByIndex	String		bindable	No
readOnly	IWDAbstractDropDown	Boolean	false	bindable	No
selectionChangeBehaviour	IWDAbstractDropDownByIndex	WDLeadSelectionChangeBehaviour	auto	not_bindable	No
state	IWDAbstractDroopDown	WDState	normal	bindable	No
textDirection	IWDAbstractDropDown	WDTextDirection	inherit	bindable	No
texts	IWDAbstractDropDoenByIndex	String		bindable_mandatory	Yes
tooltip	IWDUIElement	String		bindable	No
visible	IWDUIElemente	WDVisibility	visible	bindable	No
width	IWDAbstractDropDown	String		bindable	No