GetCapture function (winuser.h)
Retrieves a handle to the window (if any) that has captured the mouse. Only one window at a time can capture the mouse; this window receives mouse input whether or not the cursor is within its borders.
Syntax
HWND GetCapture();
Return value
Type: HWND
The return value is a handle to the capture window associated with the current thread. If no window in the thread has captured the mouse, the return value is NULL.
Remarks
A NULL return value means the current thread has not captured the mouse. However, it is possible that another thread or process has captured the mouse.
To get a handle to the capture window on another thread, use the GetGUIThreadInfo function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | winuser.h (include Windows.h) |
| Library | User32.lib |
| DLL | User32.dll |
| API set | ext-ms-win-ntuser-mouse-l1-1-0 (introduced in Windows 8) |
See also
Conceptual
Reference