CWnd::OnMouseActivate

Syntax

afx_msg int OnMouseActivate( CWnd* pFrameWnd, UINT nHitTest, UINT message );

Parameters

pFrameWnd

Specifies a pointer to the topmost parent window of the window being activated. The pointer may be temporary, and should not be stored.

nHitTest

Specifies the hit-test area code. A hit test is a test that determines the location of the cursor.

message

Specifies the message number.

Remarks

Called when the cursor is in an inactive window and the user presses a mouse button.

If the child window passes the message to the Default or DefWindowProc member function, Default or DefWindowProc passes this message to the CWnd parent window before any processing occurs. If the parent window returns TRUE, processing is halted.

For a description of the individual hit-test area codes, see the OnNcHitTest member function.

This message-handler member function calls the Default member function. Override this member function in your derived class to handle the WM_MOUSEACTIVATE message.

Return Value

Specifies whether to activate the CWnd and whether to discard the mouse event. It must be one of the following values:

Value Meaning

MA_ACTIVATE Activate CWnd.
MA_NOACTIVATE Do not activate CWnd.
MA_ACTIVATEANDEAT Activate CWnd and discard the mouse event.
MA_NOACTIVATEANDEAT Do not activate CWnd and discard the mouse event.

See Also

CWnd::OnNcHitTest, CWnd::Default, WM_MOUSEACTIVATE