WM_CTLCOLORDLG消息

在系统绘制对话框之前，已发送到对话框。通过响应此消息，对话框可以使用指定的显示设备上下文句柄设置其文本和背景色。

#define WM_CTLCOLORDLG                  0x0136

参数

如果应用程序处理此消息，则必须将句柄返回到画笔。系统使用画笔绘制对话框的背景。

默认情况下， DefWindowProc 函数选择对话框的默认系统颜色。

系统不会自动销毁返回的画笔。应用程序负责在不再需要画笔时销毁画笔。

WM_CTLCOLORDLG消息永远不会在线程之间发送。它仅在一个线程内发送。

请注意， WM_CTLCOLORDLG 消息将发送到对话框本身;所有其他 WM_CTLCOLOR* 消息将发送给控件的所有者。

如果对话框过程处理此消息，则应将所需的返回值强制转换为 INT_PTR 并直接返回该值。如果对话框过程返回 FALSE，则执行默认消息处理。 SetWindowLong 函数设置的DWL_MSGRESULT值将被忽略。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Winuser.h (包括 Windows.h)