4.36.1.1 - Функция ChooseColor

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

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

Синтаксис

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

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

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

CDERR_FINDRESFAILURE	CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION	CDERR_NOHINSTANCE
CDERR_LOCKRESFAILURE	CDERR_NOHOOK
CDERR_LOADRESFAILURE	CDERR_NOTEMPLATE
CDERR_LOADSTRFAILURE	CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE	

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

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

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

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

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков - 16.04.2002