Back to Devexpress

GridControl.SelectionChanged Event

wpf-devexpress-dot-xpf-dot-grid-dot-gridcontrol-0176ab16.md

latest6.4 KB
Original Source

GridControl.SelectionChanged Event

Occurs after grid’s selection has been changed.

Namespace : DevExpress.Xpf.Grid

Assembly : DevExpress.Xpf.Grid.v25.2.dll

NuGet Package : DevExpress.Wpf.Grid.Core

Declaration

csharp
public event GridSelectionChangedEventHandler SelectionChanged
vb
Public Event SelectionChanged As GridSelectionChangedEventHandler

Event Data

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

PropertyDescription
ActionGets an action which indicates how the grid’s selection has been changed.
ControllerRowIdentifies the row whose selected state has been changed.
HandledGets or sets a value that indicates the present state of the event handling for a routed event as it travels the route. Inherited from RoutedEventArgs.
OriginalSourceGets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs.
RoutedEventGets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs.
SourceGets the View that raised the event.

The event data class exposes the following methods:

MethodDescription
InvokeEventHandler(Delegate, Object)When overridden in a derived class, provides a way to invoke event handlers in a type-specific way, which can increase efficiency over the base implementation. Inherited from RoutedEventArgs.
OnSetSource(Object)When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes. Inherited from RoutedEventArgs.

Remarks

Each time the grid’s selection is changed, the SelectionChanged event is raised. The event parameter’s GridSelectionChangedEventArgs.Action property indicates how the grid’s selection has been changed. The GridSelectionChangedEventArgs.ControllerRow property returns the handle of a data row whose selected state has been changed.

The SelectionChanged event is not fired if the GridControl‘s DataControlBase.SelectionMode is set to MultiSelectMode.None.

To learn more, see Multiple Row Selection.

The following code snippet (auto-collected from DevExpress Examples) contains a reference 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.

wpf-data-grid-add-image-and-button-columns/CS/GridControlCellTemplate/Helpers/ReadOnSelectionBehavior.cs#L11

csharp
AssociatedObject.SelectionChanged += AssociatedObject_SelectionChanged;
AssociatedObject.SelectedItemChanged += AssociatedObject_SelectedItemChanged;

wpf-data-grid-add-image-and-button-columns/VB/GridControlCellTemplate/Helpers/ReadOnSelectionBehavior.vb#L13

vb
MyBase.OnAttached()
AddHandler AssociatedObject.SelectionChanged, AddressOf AssociatedObject_SelectionChanged
AddHandler AssociatedObject.SelectedItemChanged, AddressOf AssociatedObject_SelectedItemChanged

See Also

GridControl Class

GridControl Members

DevExpress.Xpf.Grid Namespace