Skip to main content
A newer version of this page is available. .

ColumnViewOptionsSelection.MultiSelect Property

Gets or sets whether multiple rows (cards) can be selected.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v19.2.dll

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
.OptionsSelection.MultiSelect
BandedGridView
.OptionsSelection.MultiSelect
ColumnView
.OptionsSelection.MultiSelect
CardView
.OptionsSelection.MultiSelect
GridView
.OptionsSelection.MultiSelect
LayoutView
.OptionsSelection.MultiSelect
TileView
.OptionsSelection.MultiSelect
WinExplorerView
.OptionsSelection.MultiSelect

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.

The following code snippets (auto-collected from DevExpress Examples) contain references to the MultiSelect property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also