CWnd::SetCapture

  • Article

 

Causes all subsequent mouse input to be sent to the current CWnd object regardless of the position of the cursor.

Syntax

CWnd* SetCapture();

Return Value

A pointer to the window object that previously received all mouse input. It is NULL if there is no such window. The returned pointer may be temporary and should not be stored for later use.

Remarks

When CWnd no longer requires all mouse input, the application should call the ReleaseCapture function so that other windows can receive mouse input.

While mouse input is captured, no WM_NCHITTEST or WM_SETCURSOR messages are sent to the active window.

Requirements

Header: afxwin.h

See Also

CWnd Class
Hierarchy Chart
ReleaseCapture
SetCapture
CWnd::GetCapture