WindowDragMove Method
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Allows a window to be dragged by a mouse with its left button down over an exposed area of the window's client area.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

[SecurityCriticalAttribute]
public void DragMove()
public:
[SecurityCriticalAttribute]
void DragMove()
[<SecurityCriticalAttribute>]
member DragMove : unit -> unit
<SecurityCriticalAttribute>
Public Sub DragMove
Exception Condition
InvalidOperationException

The left mouse button is not down.

The left mouse button must be down when DragMove is called. One way to detect when the left mouse button is pressed is to handle the MouseLeftButtonDown event.

When DragMove is called, the left mouse button must be depressed over an exposed area of the window's client area.

System_CAPS_noteNote

This method cannot be called when a window is hosted in a browser.

The following example shows how to override OnMouseLeftButtonDown to call DragMove.

protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)
{
    base.OnMouseLeftButtonDown(e);

    // Begin dragging the window
    this.DragMove();
}
Protected Overrides Sub OnMouseLeftButtonDown(ByVal e As MouseButtonEventArgs)
    MyBase.OnMouseLeftButtonDown(e)

    ' Begin dragging the window
    Me.DragMove()
End Sub
UIPermission

for permission to drag a window. Associated enumeration: AllWindows

.NET Framework
Available since 3.0
Silverlight
Available since 4.0
Return to top