MultiSelect Property
This property returns or sets a value indicating whether users can select multiple rows and how selections can be made.
TDBList.MultiSelect = value
Read/Write at run time and design time.
Property applies to TDBList control.
Values
|
Design Time |
Run Time |
|
0 - None (default) |
dblMultiSelectNone |
|
1 - Simple |
dblMultiSelectSimple |
|
2 - Extended |
dblMultiSelectExtended |
|
3 - Checkbox |
dblMultiSelectCheckbox |
If the MultiSelect property is 0 - None (the default), multiple selection is prohibited. Only one item in the list can be selected at any time.
If the MultiSelect property is 1 - Simple and the user clicks a row, that row is selected and the SelectedItem property returns a bookmark for that row. If more than one row is selected, the SelectedItem property returns the bookmark of the most recently selected row, and the SelBookmarks collection contains the bookmarks for all selected rows.
If the MultiSelect property is 2 - Extended, pressing Shift and clicking the mouse or pressing Shift and one of the arrow keys (Up Arrow, Down Arrow, Left Arrow, or Right Arrow) extends the selection from the previously selected item to the current item. Pressing Ctrl and clicking the mouse selects or deselects an item in the list. Since selected rows do not have to be adjacent, the user can also operate the vertical scroll bar to bring other rows into view if desired.
If the MultiSelect property is 3 - Checkbox, the user can select or unselect rows by clicking checkboxes or clicking the current row to toggle the state of the checkbox.
Note: When one of the multiple selection modes is in effect, no updates will occur.
See Also