The WM_CTLCOLOR message is used in 16-bit versions of Windows to change the color scheme of list boxes, the list boxes of combo boxes, message boxes, button controls, edit controls, static controls, and dialog boxes.
Note:
For information related to this message and 32-bit versions of Windows, see Remarks.
WM_CTLCOLOR
WPARAM wParam;
LPARAM lParam;
Parameters
hwnd
A handle to destination window.
wParam
A handle to a display context (DC).
lParam
A handle to a child window (control).
Return value
If an application processes this message, it returns a handle to a brush. The system uses the brush to paint the background of the control.
Remarks
The WM_CTLCOLOR message from 16-bit Windows has been replaced by more specific notifications. These replacements include the following:
- WM_CTLCOLORBTN
- WM_CTLCOLOREDIT
- WM_CTLCOLORDLG
- WM_CTLCOLORLISTBOX
- WM_CTLCOLORSCROLLBAR
- WM_CTLCOLORSTATIC
Requirements
| Requirement | Value |
|---|---|
| Header | WindowsX.h |
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
