DragDrop.DragLeave Attached Event

Reference

Definition

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Item	Value
Identifier field	DragLeaveEvent
Routing strategy	Bubbling
Delegate	DragEventHandler

The corresponding tunneling event is PreviewDragLeave.

Applies to

Jaa