windows_programming_notes.nbk: Home | Index | Next Page: resources | Previous Page: RegisterClassEx

 ReleaseCapture

The ReleaseCapture function releases the mouse capture from a window in the current thread and restores normal mouse input processing. A window that has captured the mouse receives all mouse input, regardless of the position of the cursor, except when a mouse button is clicked while the cursor hot spot is in the window of another thread.

Syntax

    BOOL ReleaseCapture(VOID);

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

An application calls this function after calling the SetCapture function.

Windows 95/98/Me: Calling ReleaseCapture causes the window that is losing the mouse capture to receive a WM_CAPTURECHANGED message.

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 3.1

• win32 functions
• win32 mouse input

windows_programming_notes.nbk: Home | Index | Next Page: resources | Previous Page: RegisterClassEx

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