Функция ChooseColor создает стандартное диалоговое окно Цвет(Color), которое дает возможность пользователю выбрать цвет.
Синтаксис
BOOL ChooseColor( LPCHOOSECOLOR lpcc ); |
Параметры
lpcc
[in, out] Указатель на структуру CHOOSECOLOR, которая содержит информацию, используемую, чтобы инициализировать диалоговое окно. Когда функция ChooseColor возвращает значение, эта структура содержит информацию о цвете, выбранном пользователем.Возвращаемые значения
Если пользователь щелкает по кнопке OK диалогового окна, возвращаемое значение не нуль. Член rgbResult структуры CHOOSECOLOR содержит значения RGB цвета, выбранного пользователем.
Если пользователь отменяет или закрывает диалоговое окно Цвет (Color), или происходит ошибка, возвращаемое значение нулевое. Чтобы получить дополнительные данные об ошибке, вызовите функцию CommDlgExtendedError, которая может возвратить одно из следующих значений:
CDERR_DIALOGFAILURE CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE CDERR_INITIALIZATION CDERR_NOHINSTANCE CDERR_NOHOOK CDERR_LOADRESFAILURE CDERR_NOTEMPLATE CDERR_LOADSTRFAILURE CDERR_STRUCTSIZE CDERR_MEMALLOCFAILURE
Замечания
Диалоговое окно Цвет (Color) не поддерживает палитры. Выбор цветов, предлагаемый диалоговым окном, ограничен системными цветами и сглаженными версиями этих цветов.
Вы можете предусмотреть фильтр - процедуру CCHookProc для диалогового окна Цвет (Color). Фильтр - процедура может обрабатывать сообщения, отправляемые в диалоговое окно. Чтобы подключить фильтр - процедуру, установите флажок CC_ENABLEHOOK в члене Flags структуры CHOOSECOLOR, а в ее члене lpfnHook установите адрес.
Windows 95/98/Me: ChooseColorW поддерживается программой Microsoft Layer for Unicode (MSLU).. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.
Пример
Пример смотри в статье Выбор цвета.
Смотри также
Обзор Библиотека стандартных диалоговых окон, Функции, используемые библиотекой стандартных диалоговых окон, CCHookProc, CHOOSECOLOR, CommDlgExtendedError
|
Размещение и совместимость ChooseColor |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Comdlg32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Commdlg.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |