DragDrop.DragLeave Attached Event

.NET Framework 4.6 and 4.5

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

Namespace: System.Windows
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

C++

JScript

See AddDragLeaveHandler, RemoveDragLeaveHandler

XAML Attribute Usage

<object DragDrop.DragLeave="DragEventHandler" .../>

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.

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;
    }
}

DragDrop.DragLeave Attached Event

Syntax

Remarks

Routed Event Information

Examples

Version Information

.NET Framework

.NET Framework Client Profile

See Also

Reference

Other Resources