DataViewBase.DragRecordOver Event

Occurs continuously while a record is dragged (moved) within the drop target's boundary.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v20.1.Core.dll

Declaration

public event EventHandler<DragRecordOverEventArgs> DragRecordOver
Public Event DragRecordOver As EventHandler(Of DragRecordOverEventArgs)

Event Data

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

Property Description
AllowedEffects Gets a member of the DragDropEffects enumeration that specifies which operations are allowed by the originator of the drag event. Inherited from DragEventArgsBase.
Data Gets or sets a data object that contains the data associated with the corresponding drag event. Inherited from DragEventArgsBase.
DropPosition Gets a drop position that specifies how a record is placed after it has been dropped. Inherited from DragEventArgsBase.
DropPositionRelativeCoefficient Gets a number between 0 and 1, presenting a drop position relative to the target record.
Effects Gets or sets the target drag-and-drop operation. Inherited from DragEventArgsBase.
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.
IsFromOutside Gets whether the dragged record is from another control. Inherited from DragEventArgsBase.
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. Inherited from DragEventArgsBase.
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.
TargetRecord Gets a record that is drop target. Inherited from DragEventArgsBase.
TargetRowHandle Gets the target row handle. Inherited from DragEventArgsBase.

Remarks

You can use the DragRecordOver event to deny a drop operation over specific records and specify visual feedback indicating the operation is not allowed:

<dxg:GridControl>
   <!---->
   <dxg:GridControl.View>
      <dxg:TreeListView AllowDragDrop="True" DragRecordOver="OnDragRecordOver" />
   </dxg:GridControl.View>
</dxg:GridControl>
void OnDragRecordOver(object sender, DragRecordOverEventArgs e) {
   string position = ((Employee)e.TargetRecord).Position;
   if (position == "President" || position == "Vice President") {
      e.Effects = DragDropEffects.None;
      e.Handled = true;
   }
}
See Also