Back to Devexpress

DataViewBase.CompleteRecordDragDrop Event

wpf-devexpress-dot-xpf-dot-grid-dot-dataviewbase-8855190c.md

latest5.6 KB
Original Source

DataViewBase.CompleteRecordDragDrop Event

Occurs when a drag-and-drop operation is completed.

Namespace : DevExpress.Xpf.Grid

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

NuGet Package : DevExpress.Wpf.Grid.Core

Declaration

csharp
public event EventHandler<CompleteRecordDragDropEventArgs> CompleteRecordDragDrop
vb
Public Event CompleteRecordDragDrop As EventHandler(Of CompleteRecordDragDropEventArgs)

Event Data

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

PropertyDescription
CanceledGets whether the drag-and-drop operation is canceled.
EffectsGets or sets the target drag-and-drop operation.
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.
RecordsGet dropped records.
RoutedEventGets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs.
SourceGets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs.

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

You can use CompleteRecordDragDrop event to implement a copy operation that does not remove records when dragging.

For example, if you have implemented Drag-and-Drop Between GridControls, you can handle the CompleteRecordDragDrop event to deny removing records:

xaml
<dxg:GridControl Name="gridControl1">
   <!---->
   <dxg:GridControl.View>
      <dxg:TableView AllowDragDrop="True" CompleteRecordDragDrop="OnCompleteRecordDragDrop" />
   </dxg:GridControl.View>
</dxg:GridControl>
csharp
void OnCompleteRecordDragDrop(object sender, CompleteRecordDragDropEventArgs e) {
   e.Handled = true;
}

The CompleteRecordDragDrop event is raised before the GridControl updates its ItemsSource collection. Use the Dispatcher.BeginInvoke method to invoke certain logic after the ItemsSource collection is modified.

See Also

Process Drag-and-Drop Operations

DataViewBase Class

DataViewBase Members

DevExpress.Xpf.Grid Namespace