WM_ACTIVATE

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.

This message is sent when a window is being activated or deactivated. This message is sent first to the window procedure of the top-level window being deactivated; it is then sent to the window procedure of the top-level window being activated.

WM_ACTIVATE
fActive= 
LOWORD(
wParam); 
fMinimized= 
(BOOL)HIWORD(
wParam); 
hwndPrevious= 
(HWND)
lParam;

Parameters

fActive

Value of the low-order word of wParam. Specifies whether the window is being activated or deactivated. It is one of the following values:

Value	Description
WA_ACTIVE	Activated by some method other than a mouse click (for example, by a call to the SetActiveWindowfunction or by use of the keyboard interface to select the window).
WA_CLICKACTIVE	Activated by a mouse click
WA_INACTIVE	Deactivated

fMinimized

Value of the high-order word of wParam. Specifies the minimized state of the window being activated or deactivated. A nonzero value indicates the window is minimized.

hwndPrevious

Handle to the window being activated or deactivated, depending on the value of the fActiveparameter. If the value of fActiveis WA_INACTIVE, hwndPreviousis the handle to the window being activated. If the value of fActiveis WA_ACTIVE or WA_CLICKACTIVE, hwndPreviousis the handle to the window being deactivated. This handle can be NULL, and is always NULL when the window being activated and the window being deactivated are in separate processes.

Return Values

An application should return zero if it processes this message.

Default Action

If the window is being activated and is not minimized, the DefWindowProcfunction sets the keyboard focus to the window.

Remarks

The fMinimizedparameter must be zero.

If the window is activated by a mouse click, it also receives a WM_MOUSEACTIVATE message.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Winuser.h

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

DefWindowProc, SetActiveWindow