DataViewBase.DropRecord Event
Occurs when a record is dropped on the drop target element.
Namespace: DevExpress.Xpf.Grid
Assembly: DevExpress.Xpf.Grid.v24.2.Core.dll
NuGet Package: DevExpress.Wpf.Grid.Core
#Declaration
public event EventHandler<DropRecordEventArgs> DropRecord
#Event Data
The DropRecord event's data class is DropRecordEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
Allowed |
Gets a member of the Drag |
Data |
Gets or sets a data object that contains the data associated with the corresponding drag event.
Inherited from Drag |
Drop |
Gets a drop position that specifies how a record is placed after it has been dropped.
Inherited from Drag |
Effects |
Gets or sets the target drag-and-drop operation.
Inherited from Drag |
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 Routed |
Is |
Gets whether the dragged record is from another control.
Inherited from Drag |
Key |
Gets a flag enumeration indicating the current state of the SHIFT, CTRL, and ALT keys, as well as the state of the mouse buttons.
Inherited from Drag |
Original |
Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.
Inherited from Routed |
Routed |
Gets or sets the Routed |
Source |
Gets or sets a reference to the object that raised the event.
Inherited from Routed |
Target |
Gets a record that is drop target.
Inherited from Drag |
Target |
Gets the target row handle.
Inherited from Drag |
The event data class exposes the following methods:
Method | Description |
---|---|
Get |
Gets the Type of the transferred records.
Inherited from Drag |
Invoke |
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 Routed |
On |
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 Routed |
#Remarks
You can use the DropRecord event to customize a drag-and-drop operation:
<dxg:GridControl>
<!---->
<dxg:GridControl.View>
<dxg:TreeListView AllowDragDrop="True" DropRecord="OnDropRecord" />
</dxg:GridControl.View>
</dxg:GridControl>
void OnDropRecord(object sender, DropRecordEventArgs e) {
object data = e.Data.GetData(typeof(RecordDragDropData));
foreach (Employee employee in ((RecordDragDropData)data).Records) {
employee.Position = ((Employee)e.TargetRecord).Position;
employee.Department = ((Employee)e.TargetRecord).Department;
}
if (e.DropPosition == DropPosition.Inside) {
foreach(Employee employee in ((RecordDragDropData)data).Records) {
employee.Position = "";
}
}
}
#Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the DropRecord 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.