Export (0) Print
Expand All
1 out of 6 rated this helpful - Rate this topic

WM_MOUSEACTIVATE message

Sent when the cursor is in an inactive window and the user presses a mouse button. The parent window receives this message only if the child window passes it to the DefWindowProc function.

A window receives this message through its WindowProc function.


#define WM_MOUSEACTIVATE                0x0021

Parameters

wParam

A handle to the top-level parent window of the window being activated.

lParam

The low-order word specifies the hit-test value returned by the DefWindowProc function as a result of processing the WM_NCHITTEST message. For a list of hit-test values, see WM_NCHITTEST.

The high-order word specifies the identifier of the mouse message generated when the user pressed a mouse button. The mouse message is either discarded or posted to the window, depending on the return value.

Return value

The return value specifies whether the window should be activated and whether the identifier of the mouse message should be discarded. It must be one of the following values.

Return code/valueDescription
MA_ACTIVATE
1

Activates the window, and does not discard the mouse message.

MA_ACTIVATEANDEAT
2

Activates the window, and discards the mouse message.

MA_NOACTIVATE
3

Does not activate the window, and does not discard the mouse message.

MA_NOACTIVATEANDEAT
4

Does not activate the window, but discards the mouse message.

 

Remarks

The DefWindowProc function passes the message to a child window's parent window before any processing occurs. The parent window determines whether to activate the child window. If it activates the child window, the parent window should return MA_NOACTIVATE or MA_NOACTIVATEANDEAT to prevent the system from processing the message further.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

See also

Reference
DefWindowProc
HIWORD
LOWORD
WM_NCHITTEST
Conceptual
Mouse Input

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.