TreeViewControl.ContinueRecordDrag Event
Occurs when a user presses the keyboard or mouse buttons during a drag-and-drop operation. The event allows you to cancel this operation depending on the key/button states.
Namespace: DevExpress.Xpf.Grid
Assembly: DevExpress.Xpf.Grid.v24.2.dll
NuGet Package: DevExpress.Wpf.Grid.Core
Declaration
Event Data
The ContinueRecordDrag event's data class is ContinueRecordDragEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Action | Gets or sets the status of a drag-and-drop operation. |
| Data | Gets or sets a data object that contains data associated with the DataViewBase.ContinueRecordDrag event. |
| EscapePressed | Gets whether the user pressed the ESC key. |
| Handled | Gets 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. |
| KeyStates | Gets a flag enumeration indicating the current state of the SHIFT, CTRL, and ALT keys, as well as the state of the mouse buttons. |
| OriginalSource | Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs. |
| RoutedEvent | Gets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs. |
| Source | Gets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| 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
The TreeViewControl raises the ContinueRecordDrag event continuously while a user drags a record. You can handle this event to determine what action ends the drag-and-drop operation based on the state of the ESC, SHIFT, CTRL, and ALT keys, and the state of the mouse buttons.
The default handler for this event cancels the drag-and-drop operation if a user presses the ESC key, and drops the data if a user releases the mouse button.
For information about drag-and-drop operations, refer to the following DevExpress WPF Grid help topic: Drag-and-Drop.