CWnd::SetCapture

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

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

Concepts

CWnd Members

Reference

CWnd Class

Hierarchy Chart

ReleaseCapture

SetCapture

CWnd::GetCapture

Change History

Date

History

Reason

May 2009

Added information about WM_NCHITTEST and WM_SETCURSOR.

Information enhancement.