SetCapture
The SetCapture
function sets the mouse capture to the specified window belonging to the
current thread. Once a window has captured the mouse, all mouse input is
directed to that window, regardless of whether the cursor is within the borders
of that window. Only one window at a time can capture the mouse.
If the mouse
cursor is over a window created by another thread, the system will direct mouse
input to the specified window only if a mouse button is down.
HWND SetCapture(
|
HWND hWnd |
// handle of window
to receive mouse capture |
|
); |
|
Parameters
hWnd
Identifies
the window in the current thread that is to capture the mouse.
Return Values
If the
function succeeds, the return value is the handle of the window that had
previously captured the mouse. If there is no such window, the return value is
NULL.
Remarks
Only the
foreground window can capture the mouse. When a background window attempts to
do so, the window receives messages only for mouse events that occur when the
cursor hot spot is within the visible portion of the window. Also, even if the
foreground window has captured the mouse, the user can still click another
window, bringing it to the foreground.
When the
window no longer requires all mouse input, the thread that created the window
should call the ReleaseCapture function to release the mouse.
This function
cannot be used to capture mouse input meant for another process.
Windows
95: Calling this function causes the
window that is losing the mouse capture to receive a WM_CAPTURECHANGED message.
See Also