ColumnViewOptionsSelection.MultiSelect Property
Gets or sets whether multiple rows (cards) can be selected.
Namespace: DevExpress.XtraGrid.Views.Base
Assembly: DevExpress.XtraGrid.v22.2.dll
NuGet Package: DevExpress.Win.Grid
Declaration
[DefaultValue(false)]
[XtraSerializableProperty]
public virtual bool MultiSelect { get; set; }
Property Value
Type | Default | Description |
---|---|---|
Boolean | false | true, to allow multiple row (card) selections; otherwise, false. |
Property Paths
You can access this nested property as listed below:
Object Type | Path to MultiSelect |
---|---|
AdvBandedGridView |
|
BandedGridView |
|
ColumnView |
|
CardView |
|
GridView |
|
ItemsView |
|
LayoutView |
|
TileView |
|
WinExplorerView |
|
Remarks
Refer to the Multiple Row and Cell Selection and End-User Capabilities: Selecting Rows/Cards documents for information on how multiple rows and cards can be selected by end-users and in code.
Use the GridOptionsSelection.MultiSelectMode property to specify whether multiple row or cell selection is enabled.
Note
If neighboring cells with identical values are allowed to be merged (the GridOptionsView.AllowCellMerge option is enabled), multiple rows cannot be selected regardless of the MultiSelect property’s value.
The code sample below illustrates how to enable multiple row/cell selection in a grid control.
// This property controls whether multi-select feature is enabled
gridView.OptionsSelection.MultiSelect = true;
// Controls whether multiple cells or rows can be selected
gridView.OptionsSelection.MultiSelectMode = GridMultiSelectMode.RowSelect;
// Available modes:
// CellSelect - Individual cells and blocks of cells can be selected.
// CheckBoxRowSelect - Multiple rows can be selected using the mouse, keyboard and built-in Check column. Individual cells cannot be selected.
// RowSelect - Multiple rows can be selected using the mouse and keyboard. Individual cells cannot be selected.