Window.DragMove Method (System.Windows)

Switch View :
ScriptFree
.NET Framework Class Library
Window.DragMove Method

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)
Syntax

Visual Basic
Public Sub DragMove
C#
public void DragMove()
Visual C++
public:
void DragMove()
F#
member DragMove : unit -> unit 

Exceptions

Exception Condition
InvalidOperationException

The left mouse button is not down.

Remarks

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.

Note Note

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

Examples

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

Visual Basic

Protected Overrides Sub OnMouseLeftButtonDown(ByVal e As MouseButtonEventArgs)
    MyBase.OnMouseLeftButtonDown(e)

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


C#

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

    // Begin dragging the window
    this.DragMove();
}


Version Information

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
.NET Framework Security

  • UIPermission  

    for permission to drag a window. Associated enumeration: AllWindows

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also

Reference