 |
AspLib component library | Send comments on this topic. |
Glossary Item Box
|
AspLib component library | Send comments on this topic. |
This control provides a simple and intuitive way for a user to make multiple item selections. Available items are displayed in one list, selected items displayed in another. It is possible to filter elements using Filter text field. It is also possible to display tip with additional description for each item.
This control works without postback between the movement of the Lists and has AutoSorting and PreSelect properties. Data binding for Select and PreSelect properties. DataSource can be DataSet, DataTable, Array or Collection.
Control supports AJAX behavior: partially items loading and fast items uploading for large items collections.
Features:
Default DualSelectBox view sample:
DualSelectBox can show not only text lists, but also value lists and value filter. This lists is synchronized with text lists.
To show value list set property HasValueList="True"
To set the configuration of the lists in DualSelectBox control (text list, value list, or both), change value of the property ListsConfiguration. Available values are:
| Value | Description |
| Text | Display only text list. |
| Value | Display only value list. |
| ValueText | Display both text and value lists. Value list is on the left. |
| TextValue | Display both text and value lists. Text list is on the left. |
DualSelectBox appearance may be Horizontal and Vertical:
Set property ControlOrientation="Vertical"
DualSelectBox with vertical orientation and value list:
Control has AJAX behavior. It may loads collection of values only after clicking on "Upload next items" button. It decreases traffic and speed when working with large items collection.
To enable AJAX behavior set property:
EnableAjaxBehavior=True
Initially by default DualSelectBox shows 25 first items that matches the search criteria (the count of items for each single request is setted by property ItemRequestCount).
When AJAX behavior is enabled control shows status bar with already uploaded items counter, loading status and "Upload next" button. When "Upload next" button pressed ComboBox requests next items that matches the search criteria.
Use keyboard to navigate DualSelectBox.
In DualSelectBox list - press Enter key to copy items into another list.
| See Also |
Client-side API: DualSelectBox client side API
Overview: Overview