Сообщение WM_CTLCOLORDLG отправляется диалоговому окну перед тем, как система нарисует блок диалога. Отвечая на это сообщение, диалоговое окно может устанавливать свой текст и цвета фона, используя дескриптор контекста устройства заданного устройства отображения.
Синтаксис
WM_CTLCOLORDLG WPARAM wParam LPARAM lParam; |
Параметры
wParam
Дескриптор контекста устройства диалогового окна.
lParam
Дескриптор диалогового окна.
Возвращаемое значение
Если приложение обрабатывает это сообщение, оно должно возвратить дескриптор кисти. Система использует кисть, чтобы окрашивать фон диалогового окна.
Замечания
По умолчанию, функция DefWindowProc выбирает заданные по умолчанию системные цвета для диалогового окна.
Система автоматически не уничтожает возвращенную кисть. Это - задача приложения уничтожить кисть, когда она больше не нужна.
Сообщение WM_CTLCOLORDLG никогда не пересылается между потоками. Оно отправляется только внутри единственного потока.
Обратите внимание! на то, что сообщение WM_CTLCOLORDLG отправляется в диалоговое окно непосредственно; все остальные WM_CTLCOLOR* сообщения отправляются владельцу органа управления. |
Если процедура диалогового окна обрабатывает это сообщение, она должна привести требуемое возвращаемое значение к INT_PTR и возвратить это значение непосредственно. Если процедура диалогового окна возвращает ЛОЖЬ (FALSE), то установите выполнение обработки сообщения по умолчанию. Значение DWL_MSGRESULT, установленное функцией SetWindowLong игнорируется.
Смотри также
Обзор Диалоговые окна, DefWindowProc, RealizePalette, SelectPalette, SetWindowLong
Размещение и совместимость WM_CTLCOLORDLG |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
Нет |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |