Multi-Selection Mode
The ASPxListBox editor from the ASPxEditors Suite enables end-users to select mutiple items simultaneously.
To enable multi-selection mode, set the editor’s ASPxListBox.SelectionMode property to ListEditSelectionMode.Multiple or ListEditSelectionMode.CheckColumn.
Note
In multiple selection mode, all list items are always sent to the client, and loading items on demand via callbacks is not supported. So, the editor’s ListBoxProperties.EnableCallbackMode and ListBoxProperties.CallbackPageSize properties are not in effect.
An individual item can be selected on the server side by using the ListEditItem.Selected property. The ASPxListBox.SelectAll and ASPxListBox.UnselectAll methods select or deselect all items on the server.
The following client side API is useful in changing the selected state of editor items.
Use the following members to obtain information about the selected items, programmatically.
| On the server side | On the client side |
|---|---|
| ASPxListBox.SelectedItems | ASPxClientListBox.GetSelectedItems |
| ASPxListBox.SelectedIndices | ASPxClientListBox.GetSelectedIndices |
| ASPxClientListBox.GetSelectedValues |
The client ASPxClientListBox.SelectedIndexChanged and server ASPxListEdit.SelectedIndexChanged events are useful for performing tasks in response to an end-user selecting a different item from the editor’s list.