Win32 API. Справочник по стандартному диалоговому окну
Страница 2. Функция ChooseColor


Функция ChooseColor

(ВыборЦвета)

Функция ChooseColor создает стандартное диалоговое окно Цвет(Color), которое дает возможность пользователю выбрать цвет.

Синтаксис

BOOL ChooseColor
(
LPCHOOSECOLOR lpcc // указывает на структуру с данными инициализации
);

Параметры
lpcc
Указатель на структуру CHOOSECOLOR, которая содержит информацию, используемую, чтобы инициализировать диалоговое окно. Когда функция ChooseColor возвращает значение, эта структура содержит информацию о цвете, выбранном пользователем.

Возвращаемые значения
Если пользователь щелкает мышью по кнопке OK диалогового окна, возвращаемое значение не нуль. Элемент rgbResult структуры CHOOSECOLOR содержит значения RGB цвета, выбранного пользователем.
Если пользователь отменяет или закрывает Диалоговое окно Цвет (Color), или происходит ошибка, возвращаемое значение нулевое. Чтобы получить дополнительные данные об ошибке, вызовите функцию CommDlgExtendedError, которая может возвратить одно из следующих значений:

CDERR_FINDRESFAILURECDERR_MEMLOCKFAILURE
CDERR_INITIALIZATIONCDERR_NOHINSTANCE
CDERR_LOCKRESFAILURECDERR_NOHOOK
CDERR_LOADRESFAILURECDERR_NOTEMPLATE
CDERR_LOADSTRFAILURECDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE

Замечания
Диалоговое окно Цвет (Color) не поддерживает палитры. Выбор цветов, предлагаемый диалоговым окном, ограничен цветами системы и размытыми версиями этих цветов.
Вы можете предоставить фильтр - процедуру CCHookProc для диалогового окна Цвет (Color). Фильтр - процедура может обрабатывать сообщения, посылаемые в диалоговое окно. Чтобы подключить фильтр - процедуру, установите флажок CC_ENABLEHOOK в элементе Flags структуры CHOOSECOLOR и установите адрес ее в элементе lpfnHook.

Смотри также
CCHookProc, CHOOSECOLOR, CommDlgExtendedError

Размещение и совместимость ChooseColor.

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаcomdlg32.lib
Заголовочный файлcommdlg.h
УникодWinNT
Замечания по платформеНе имеется

 

 
« Предыдущая статья   Следующая статья »