Skip to content

Latest commit

 

History

History
80 lines (48 loc) · 2.33 KB

wm-syscolorchange.md

File metadata and controls

80 lines (48 loc) · 2.33 KB
description ms.assetid title ms.topic ms.date
The WM\_SYSCOLORCHANGE message is sent to all top-level windows when a change is made to a system color setting.
ffe61768-86d6-4ea8-ae2d-1095a9afa925
WM_SYSCOLORCHANGE message (Winuser.h)
reference
05/31/2018

WM_SYSCOLORCHANGE message

The WM_SYSCOLORCHANGE message is sent to all top-level windows when a change is made to a system color setting.

A window receives this message through its WindowProc function.

LRESULT CALLBACK WindowProc(
  HWND hwnd, 
  UINT  uMsg, 
  WPARAM wParam, 
  LPARAM lParam     
);

Parameters

wParam

This parameter is not used.

lParam

This parameter is not used.

Remarks

The system sends a WM_PAINT message to any window that is affected by a system color change.

Applications that have brushes using the existing system colors should delete those brushes and re-create them using the new system colors.

Top level windows that use common controls must forward the WM_SYSCOLORCHANGE message to the controls; otherwise, the controls will not be notified of the color change. This ensures that the colors used by your common controls are consistent with those used by other user interface objects. For example, a toolbar control uses the "3D Objects" color to draw its buttons. If the user changes the 3D Objects color but the WM_SYSCOLORCHANGE message is not forwarded to the toolbar, the toolbar buttons will remain in their original color while the color of other buttons in the system changes.

Requirements

Requirement Value
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

Colors Overview

Color Messages

WM_PAINT