WM_SYSCOLORCHANGE

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

WM_SYSCOLORCHANGE 

Parameters

None.

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 recreate 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 are not 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 remain in their original color while the color of other buttons in the system changes.

Requirements

Header winuser.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

WM_PAINT