Класс CMFCColorDialog
Класс CMFCColorDialog представляет диалоговое окно выбора цвета.
Синтаксис
class CMFCColorDialog : public CDialogEx
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| CMFCColorDialog::CMFCColorDialog | Формирует объект CMFCColorDialog. |
CMFCColorDialog::~CMFCColorDialog |
Деструктор. |
Открытые методы
| Имя | Описание |
|---|---|
| CMFCColorDialog::GetColor | Возвращает текущий выбранный цвет. |
| CMFCColorDialog::GetPalette | Возвращает палитру цвета. |
CMFCColorDialog::PreTranslateMessage |
Преобразует сообщения окна перед отправкой в функции TranslateMessage и DispatchMessage Windows. Дополнительные сведения см. в разделе CWnd::P reTranslateMessage. (Переопределяет CDialogEx::PreTranslateMessage.) |
| CMFCColorDialog::RebuildPalette | Получает палитру из системной палитры. |
| CMFCColorDialog::SetCurrentColor | Задает текущий выбранный цвет. |
| CMFCColorDialog::SetNewColor | Задает цвет, наиболее эквивалентный указанному значению RGB. |
| CMFCColorDialog::SetPageOne | Выбирает значение RGB для первой страницы свойств. |
| CMFCColorDialog::SetPageTwo | Выбирает значение RGB для второй страницы свойств. |
Защищенные члены данных
| Имя | Описание |
|---|---|
m_bIsMyPalette |
ЗНАЧЕНИЕ TRUE, если диалоговое окно выбора цвета использует собственную цветовую палитру или false, если диалоговое окно использует палитру, указанную в конструкторе CMFCColorDialog . |
m_bPickerMode |
ЗНАЧЕНИЕ TRUE, когда пользователь выбирает цвет в диалоговом окне выбора; в противном случае — ЗНАЧЕНИЕ FALSE. |
m_btnColorSelect |
Выбранная пользователем кнопка цвета. |
m_CurrentColor |
Выбранный в данный момент цвет. |
m_hcurPicker |
Курсор, используемый для выбора цвета. |
m_NewColor |
Потенциальный выбранный цвет, который можно окончательно выбрать или вернуть к исходному цвету. |
m_pColourSheetOne |
Указатель на первую страницу свойств листа свойств выбора цвета. |
m_pColourSheetTwo |
Указатель на вторую страницу свойств листа свойств выбора цвета. |
m_pPalette |
Текущая логическая палитра. |
m_pPropSheet |
Указатель на лист свойств для диалогового окна выбора цвета. |
m_wndColors |
Объект элемента управления "Выбор цвета". |
m_wndStaticPlaceHolder |
Статический элемент управления, являющийся заполнителем для листа свойств средства выбора цвета. |
Замечания
Диалоговое окно выбора цвета отображается в виде листа свойств с двумя страницами. На первой странице вы выбираете стандартный цвет из системной палитры; На второй странице вы выбираете настраиваемый цвет.
Объект можно создать CMFCColorDialog в стеке, а затем вызвать DoModal, передав начальный цвет в качестве параметра конструктору CMFCColorDialog . Затем диалоговое окно выбора цвета создает несколько объектов класса CMFCColorPickerCtrl для обработки каждой цветовой палитры.
Иерархия наследования
Пример
В следующем примере показано, как настроить диалоговое окно цвета с помощью различных методов в CMFCColorDialog классе. В примере показано, как задать текущие и новые цвета диалогового окна, а также задать красные, зеленые и синие компоненты выбранного цвета на двух страницах свойств диалогового окна цвета. Этот пример является частью примера "Новые элементы управления".
// COLORREF m_Color
CMFCColorDialog dlg(m_Color, 0, this);
dlg.SetCurrentColor(RGB(0, 255, 0));
dlg.SetNewColor(RGB(0, 0, 255));
// set the red, green, and blue components of a selected
// color on the two property pages of the color dialog
dlg.SetPageOne(255, 0, 0);
dlg.SetPageTwo(0, 255, 0);
Требования
Заголовок: afxcolordialog.h
CMFCColorDialog::CMFCColorDialog
Формирует объект CMFCColorDialog.
CMFCColorDialog(
COLORREF clrInit=0,
DWORD dwFlags=0,
CWnd* pParentWnd=NULL,
HPALETTE hPal=NULL);
Параметры
clrInit
[in] Выбор цвета по умолчанию. Если значение не указано, по умолчанию используется RGB(0,0,0) (черный).
dwFlags
[in] Зарезервировано.
pParentWnd
[in] Указатель на окно родительского или владельца диалогового окна.
hPal
[in] Дескриптор цветовой палитры.
Возвращаемое значение
Замечания
CMFCColorDialog::GetColor
Извлекает цвет, который пользователь выбирает из диалогового окна цвета.
COLORREF GetColor() const;
Возвращаемое значение
Значение COLORREF, содержащее сведения RGB для цвета, выбранного в диалоговом окне цвета.
Замечания
Вызовите эту функцию после вызова DoModal метода.
CMFCColorDialog::GetPalette
Извлекает цветовую палитру, доступную в текущем диалоговом окне цвета.
CPalette* GetPalette() const;
Возвращаемое значение
Указатель на объект, указанный CPalette в конструкторе CMFCColorDialog .
Замечания
Цветовая палитра задает цвета, которые пользователь может выбрать.
CMFCColorDialog::RebuildPalette
Получает палитру из системной палитры.
void RebuildPalette();
CMFCColorDialog::SetCurrentColor
Задает текущий цвет диалогового окна.
void SetCurrentColor(COLORREF rgb);
Параметры
rgb
[in] Значение цвета RGB
Замечания
CMFCColorDialog::SetNewColor
Задает текущий цвет в текущей палитре, который наиболее похож.
void SetNewColor(COLORREF rgb);
Параметры
rgb
[in] Объект COLORREF , указывающий цвет RGB.
Замечания
CMFCColorDialog::SetPageOne
Явно задает красные, зеленые и синие компоненты выбранного цвета на первой странице свойств диалогового окна цвета.
void SetPageOne(
BYTE R,
BYTE G,
BYTE B);
Параметры
R
[in] Указывает красный компонент значения RGB.
G
[in] Задает зеленый компонент значения RGB.
B
[in] Указывает синий компонент значения RGB.
Замечания
CMFCColorDialog::SetPageTwo
Явно указывает красные, зеленые и синие компоненты выбранного цвета на второй странице свойства диалогового окна цвета.
void SetPageTwo(
BYTE R,
BYTE G,
BYTE B);
Параметры
R
[in] Указывает красный компонент значения RGB
G
[in] Указывает зеленый компонент значения RGB
B
[in] Указывает синий компонент значения RGB