windows_programming_notes.nbk: Home | Index | Next Page: WM_NCCALCSIZE | Previous Page: WM_MOVING

 WM_NCACTIVATE

The WM_NCACTIVATE message is sent to a window when its nonclient area needs to be changed to indicate an active or inactive state.

A window receives this message through its WindowProc function.

Syntax

    WM_NCACTIVATE
        WPARAM wParam
        LPARAM lParam;

Parameters

• wParam
  Specifies when a title bar or icon needs to be changed to indicate an active or inactive state. If an active title bar or icon is to be drawn, the wParam parameter is TRUE. It is FALSE for an inactive title bar or icon.
• lParam This parameter is not used.

Return Value

When the wParam parameter is FALSE, an application should return TRUE to indicate that the system should proceed with the default processing, or it should return FALSE to prevent the title bar or icon from being deactivated. When wParam is TRUE, the return value is ignored.

Remarks

The DefWindowProc function draws the title bar or icon title in its active colors when the wParam parameter is TRUE and in its inactive colors when wParam is FALSE.

Notification Requirements

• Minimum DLL Version None
• Header Declared in Winuser.h, include Windows.h
• Minimum operating systems Windows 95, Windows NT 3.1

windows_programming_notes.nbk: Home | Index | Next Page: WM_NCCALCSIZE | Previous Page: WM_MOVING

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time