ColumnView.SelectionChanged Event

Fires when row/cell selection is changed in multiple selection mode.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

[DXCategory("Property Changed")]
public event SelectionChangedEventHandler SelectionChanged

VB.NET

<DXCategory("Property Changed")>
Public Event SelectionChanged As SelectionChangedEventHandler

Event Data

The SelectionChanged event's data class is SelectionChangedEventArgs. The following properties provide information specific to this event:

Property	Description
Action	Gets an action which describes how the collection has been changed.
ControllerRow	Identifies the row whose selected state has been changed.

Remarks

If the ColumnViewOptionsSelection.MultiSelect property is set to true, it’s possible to select multiple rows or cells simultaneously. In this mode, modifying row/cell selection fires the SelectionChanged event. If a specific row/cell is selected, the SelectionChanged event will also fire every time the grid’s data is grouped and/or filtered.

Do not rely your business logic on the Action parameter, as its meaning may be changed in the future. Currently, when rows are selected, the SelectionChanged event fires with the Action parameter set to Add or Refresh (depending on how rows are selected). When rows are deselected, the Action parameter will be either Remove or Refresh (depending on how rows are deselected).

The SelectionChangedEventArgs.ControllerRow property may return the GridControl.InvalidRowHandle property’s value when a single row is selected. It also returns this value after the selected row collection has been refreshed. For instance, this happens after the data has been grouped or filtered, or after a batch selection modification (see BaseView.BeginSelection).

To obtain currently selected rows and cells, use the ColumnView.GetSelectedRows and GridView.GetSelectedCells methods.

For information on selecting rows/cells in code, see Multiple Row and Cell Selection.

For information on selecting rows/cells at runtime by end-users, refer to End-User Capabilities: Selecting Rows/Cards.

If the ColumnViewOptionsSelection.MultiSelect property is set to false, the multiple row selection feature is disabled. In this mode, the SelectionChanged event doesn’t fire when focus moves between rows. To respond to focus moving from one row or card to another (even when multiple selection mode isn’t used), you can handle the ColumnView.FocusedRowChanged event.

Note

Rows cannot be selected if merging neighboring cells with identical values is allowed (the GridOptionsView.AllowCellMerge option is enabled).

Related GitHub Examples

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

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.

C#

how-to-get-xtrascheduler-synchronized-with-xtragrid-xpo-version-e995/CS/MainForm.cs#L105

    this.schedulerControl1.SelectionChanged += new System.EventHandler(this.schedulerControl1_SelectionChanged);
    this.gridView1.SelectionChanged += new DevExpress.Data.SelectionChangedEventHandler(this.gridView1_SelectionChanged);
}

how-to-get-xtrascheduler-synchronized-with-xtragrid-e792/CS/Form1.cs#L473

    this.schedulerControl1.SelectionChanged += new System.EventHandler(this.schedulerControl1_SelectionChanged);
    this.gridView1.SelectionChanged += new DevExpress.Data.SelectionChangedEventHandler(this.gridView1_SelectionChanged);
}

how-to-select-all-detail-rows-when-selecting-a-master-row-checkboxrowselection-mode-t130639/CS/MasterDetailSelectionHelper.cs#L20

    _GridView.MasterRowExpanded += _GridView_MasterRowExpanded;
    _GridView.SelectionChanged += _GridView_SelectionChanged;
}

how-to-copy-a-cells-value-to-other-cells-by-dragging-its-right-bottom-edge-e2621/CS/Classes/DragCellsValuesHelper.cs#L45

    View.ShowingEditor += new CancelEventHandler(View_ShowingEditor);
    View.SelectionChanged += new DevExpress.Data.SelectionChangedEventHandler(View_SelectionChanged);
}

VB.NET

how-to-get-xtrascheduler-synchronized-with-xtragrid-xpo-version-e995/VB/MainForm.vb#L118

    AddHandler schedulerControl1.SelectionChanged, AddressOf schedulerControl1_SelectionChanged
    AddHandler gridView1.SelectionChanged, AddressOf gridView1_SelectionChanged
End Sub

how-to-get-xtrascheduler-synchronized-with-xtragrid-e792/VB/Form1.vb#L440

    AddHandler schedulerControl1.SelectionChanged, AddressOf schedulerControl1_SelectionChanged
    AddHandler gridView1.SelectionChanged, AddressOf gridView1_SelectionChanged
End Sub

how-to-select-all-detail-rows-when-selecting-a-master-row-checkboxrowselection-mode-t130639/VB/MasterDetailSelectionHelper.vb#L18

    AddHandler _GridView.MasterRowExpanded, AddressOf _GridView_MasterRowExpanded
    AddHandler _GridView.SelectionChanged, AddressOf _GridView_SelectionChanged
End Sub

how-to-copy-a-cells-value-to-other-cells-by-dragging-its-right-bottom-edge-e2621/VB/Classes/DragCellsValuesHelper.vb#L45

    AddHandler View.ShowingEditor, AddressOf View_ShowingEditor
    AddHandler View.SelectionChanged, AddressOf View_SelectionChanged
End Sub