DragDrop.DragLeave Attached Event

Definition

Occurs when an object is dragged out of the bounds of an element that is acting as a drop target without being dropped.

see AddDragLeaveHandler, and RemoveDragLeaveHandler
see AddDragLeaveHandler, and RemoveDragLeaveHandler
see AddDragLeaveHandler, and RemoveDragLeaveHandler

Examples

The following example shows the DragLeave event handler for an Ellipse element. This code undoes the preview performed in the DragEnter event handler by applying the saved Brush to the ellipse.

private void ellipse_DragLeave(object sender, DragEventArgs e)
{
    Ellipse ellipse = sender as Ellipse;
    if (ellipse != null)
    {
        ellipse.Fill = _previousFill;
    }
}
Private Sub Ellipse_DragLeave(ByVal sender As System.Object, ByVal e As System.Windows.DragEventArgs)
    Dim ellipse = TryCast(sender, Ellipse)
    If ellipse IsNot Nothing Then
        ellipse.Fill = _previousFill
    End If
End Sub

Remarks

This event is raised once each time an object is dragged out of the bounds of an element that is acting as a drop target without being dropped. This event is not raised if the element's AllowDrop property is false.

You typically handle this event to undo any changes that you made in the DragEnter event handler.

Routed Event Information

Identifier field DragLeaveEvent
Routing strategy Bubbling
Delegate DragEventHandler

The corresponding tunneling event is PreviewDragLeave.

Applies to

See also