Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This message is sent to a window if the mouse causes the cursor to move within a window and mouse input is not captured.

Syntax 

WM_SETCURSOR 
hwnd = (HWND) 
wParam;

nHittest = LOWORD (
lParam);

wMouseMsg = HIWORD (
lParam);

Parameters

hwnd

Handle to the window that contains the cursor.

nHittest

Value of the low-order word of lParam. Specifies the hit-test code.

wMouseMsg

Value of the high-order word of lParam. Specifies the identifier of the mouse message.

Return Value

The default action is that the DefWindowProcfunction passes the WM_SETCURSOR message to a parent window before processing. If the parent window returns TRUE, further processing is halted. Passing the message to a window's parent window gives the parent window control over the cursor's setting in a child window. The DefWindowProcfunction also uses this message to set the cursor to an arrow if it is not in the client area, or to the registered class cursor if it is in the client area. If the low-order word of the lParamparameter is HTERROR and the high-order word of lParamspecifies that one of the mouse buttons is pressed, DefWindowProccalls the MessageBeepfunction.

Remarks

The high-order word of lParamis zero when the window enters menu mode.

Requirements

Header winuser.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also