Класс CColorDialog

Статья
06/10/2015

Позволяет включить диалоговое окно цвет- выделения в приложение.

class CColorDialog : public CCommonDialog

Члены

Открытые конструкторы

Имя	Описание
CColorDialog::CColorDialog	Создает объект CColorDialog.

Открытые методы

Имя	Описание
CColorDialog::DoModal	Отображает диалоговое окно цвет, и позволяет пользователю выполнить выделение.
CColorDialog::GetColor	Возвращает структуру COLORREF, содержащий значения выбранного цвета.
CColorDialog::GetSavedCustomColors	Получает цвет, созданные пользователем.
CColorDialog::SetCurrentColor	Проверяет текущее выделение цвета в указанный цвет.

Защищенные методы

Имя	Описание
CColorDialog::OnColorOK	Переопределение для проверки цвета, введенный в диалоговое окно.

Открытые члены данных

Имя	Описание
CColorDialog::m_cc	Структура, используемая для настройки параметры диалогового окна.

Заметки

Объект CColorDialog диалоговое окно со списком цветов, которые определены для отображения системных. Пользователь может выбрать или создать указанный основной цвет из списка, затем обратно к приложению, когда отображается диалоговое окно будет.

Создание объекта CColorDialog, использовать предоставленный конструктор или наследовать новый класс и использовать собственный пользовательский конструктор.

Как только было создано диалоговое окно можно задавать или изменять все значения в структуре m_cc для инициализации значений элементов управления диалогового окна. Структура m_cc типа CHOOSECOLOR.

После инициализации элементов управления диалогового окна, вызовите функцию-член DoModal для отображения диалогового окна и, чтобы разрешить пользователю выбирать цвета. Возвращает DoModal выделения пользователя или диалогового окна ОДОБРЕННОГО (IDOK) или кнопку "Отмена" (IDCANCEL).

Если DoModal возвращает IDOK, можно использовать один из CColorDialog функции-члены для получения ввода информации пользователем.

Можно использовать функцию Windows CommDlgExtendedError чтобы определить, произошла ли ошибка во время инициализации диалогового окна и получить дополнительные сведения об ошибке.

CColorDialog основан на файле COMMDLG.DLL, который поставляется с версиями Windows 3,1 и более поздних версий.

Настраивать диалоговое окно создать класс, производный от CColorDialog, предоставить пользовательский шаблон диалогового окна, и добавить сопоставление сообщений для обработки сообщений уведомлений от расширенных элементов управления. Все необработанных сообщений должны быть переданы на базовый класс.

Функция обработчика настройке не требуется.

Примечание

На некоторых типах установки объект CColorDialog не отображают с серым фоном при использовании границы, чтобы сделать другой серый цвет объектов CDialog.

Дополнительные сведения об использовании CColorDialog см. в разделе Общие классы диалоговых окон