WM_POINTERACTIVATE message

Sent to an inactive window when a primary pointer generates a WM_POINTERDOWN over the window. As long as the message remains unhandled, it travels up the parent window chain until it is reaches the top-level window. Applications can respond to this message to specify whether they wish to be activated.

A window receives this message through its WindowProc function.

#define WM_POINTERACTIVATE             0x024B

Parameters

wParam

Contains the pointer identifier and additional information. Use the following macros to retrieve this information.

GET_POINTERID_WPARAM(wParam): pointer identifier

HIWORD(wParam): hit-test value returned from processing the WM_NCHITTEST message.

lParam

Contains the handle to the top-level window of the window being activated.

Return value

If an application processes this message, it should return one of the values described in the Remarks section.

If the application does not process this message, it should call DefWindowProc.

Remarks

An application can handle this message and return one of the following values to determine how the system processes the activation and the activating input:

• PA_ACTIVATE
• PA_NOACTIVATE

It is important to note that, when the user is interacting with the system with multiple simultaneous pointers, the activation opportunity that the WM_POINTERACTIVATE message represents is available to applications only for the first of those pointers. Applications should, therefore, be aware that they may still receive input from pointers while they are inactive.

If the application does not handle this message, DefWindowProc passes the message to the parent window.

Requirements

See also

Messages