windows_programming_notes.nbk: Home | Index | Next Page: Drawing Lines with the Mouse | Previous Page: DM_SETDEFID

 DragDetect

The DragDetect function captures the mouse and tracks its movement until the user releases the left button, presses the ESC key, or moves the mouse outside the drag rectangle around the specified point. The width and height of the drag rectangle are specified by the SM_CXDRAG and SM_CYDRAG values returned by the GetSystemMetrics function.

Syntax

    BOOL DragDetect(  
        HWND hwnd,
        POINT pt
    );

Parameters

• hwnd
  [in] Handle to the window receiving mouse input.
• pt
  [in] Initial position of the mouse, in screen coordinates. The function determines the coordinates of the drag rectangle by using this point.

Return Value

If the user moved the mouse outside of the drag rectangle while holding down the left button, the return value is nonzero.

If the user did not move the mouse outside of the drag rectangle while holding down the left button, the return value is zero.

Remarks

The system metrics for the drag rectangle are configurable, allowing for larger or smaller drag rectangles.

Function Information

• Minimum DLL Version user32.dll
• Header Declared in Winuser.h, include Windows.h
• Import library User32.lib
• Minimum operating systems Windows 95, Windows NT 4.0

• win32 functions
• win32 mouse input

windows_programming_notes.nbk: Home | Index | Next Page: Drawing Lines with the Mouse | Previous Page: DM_SETDEFID

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time