Класс CMFCPropertyGridColorProperty

Класс CMFCPropertyGridColorProperty поддерживает элемент управления списка свойств, открывающий диалоговое окно выбора цвета.

Синтаксис

class CMFCPropertyGridColorProperty : public CMFCPropertyGridProperty

Участники

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

Имя	Описание
CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty	Формирует объект CMFCPropertyGridColorProperty.
CMFCPropertyGridColorProperty::~CMFCPropertyGridColorProperty	Деструктор.

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

Имя	Описание
CMFCPropertyGridColorProperty::EnableAutomaticButton	Включает автоматическую кнопку в диалоговом окне выбора цвета. (Стандартная автоматическая кнопка помечена Автоматически.)
CMFCPropertyGridColorProperty::EnableOtherButton	Включает другую кнопку в диалоговом окне выбора цвета. (Стандартная другая кнопка помечена Дополнительные цвета.)
CMFCPropertyGridColorProperty::FormatProperty	Форматирует текстовое представление значения свойства. (Переопределения CMFCPropertyGridProperty::FormatProperty.)
CMFCPropertyGridColorProperty::GetColor	Возвращает текущий цвет свойства.
CMFCPropertyGridColorProperty::GetThisClass	Используется платформой для получения указателя на объект CRuntimeClass , связанный с этим типом класса.
CMFCPropertyGridColorProperty::OnClickButton	Вызывается платформой, когда пользователь нажимает кнопку, содержащуюся в свойстве. (Переопределения CMFCPropertyGridProperty::OnClickButton.)
CMFCPropertyGridColorProperty::OnDrawValue	Вызывается платформой для отображения значения свойства. (Переопределения CMFCPropertyGridProperty::OnDrawValue.)
CMFCPropertyGridColorProperty::OnEdit	Вызывается платформой непосредственно перед изменением значения свойства пользователем. (Переопределения CMFCPropertyGridProperty::OnEdit.)
CMFCPropertyGridColorProperty::OnUpdateValue	Вызывается платформой при присвоении изменяемому свойству нового значения. (Переопределения CMFCPropertyGridProperty::OnUpdateValue.)
CMFCPropertyGridColorProperty::SetColor	Задает новый цвет свойства.
CMFCPropertyGridColorProperty::SetColumnsNumber	Задает число столбцов в текущей таблице свойств цвета.
CMFCPropertyGridColorProperty::SetOriginalValue	Задает изменяемому свойству изначальное значение.

Замечания

Класс CMFCPropertyGridColorProperty поддерживает свойство цвета, которое можно добавить в элемент управления "список свойств". Дополнительные сведения см. в классе CMFCPropertyGridCtrl.

Пример

В следующем примере демонстрируется создание объекта класса CMFCPropertyGridColorProperty и его настройка с помощью различных методов класса CMFCPropertyGridColorProperty. В коде показывается, как можно задействовать кнопки автоматического выбора и выбора другого цвета, а также выполняется назначение цвета и количества столбцов. Этот пример является частью примера "Новые элементы управления".

CMFCPropertyGridColorProperty *pColorProp = new CMFCPropertyGridColorProperty(_T("Window Color"), RGB(210, 192, 254), NULL, _T("Specifies the default dialog color"));
pColorProp->EnableOtherButton(_T("Other..."));
pColorProp->EnableAutomaticButton(_T("Default"), ::GetSysColor(COLOR_3DFACE));
pColorProp->SetColor(RGB(255, 0, 0));
pColorProp->SetColumnsNumber(3);

Иерархия наследования

CObject

CMFCPropertyGridProperty

CMFCPropertyGridColorProperty

Требования

Заголовок: afxpropertygridctrl.h

CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty

Формирует объект CMFCPropertyGridColorProperty.

CMFCPropertyGridColorProperty(
    const CString& strName,
    const COLORREF& color,
    CPalette* pPalette = NULL,
    LPCTSTR lpszDescr = NULL,
    DWORD_PTR dwData = 0);

Параметры

strName
[in] Имя свойства.

color
[in] Значение цвета свойства.

pPalette
[in] Указатель на палитру цветов. Значение по умолчанию — NULL.

lpszDescr
[in] Описание свойства. Значение по умолчанию — NULL.

dwData
[in] Данные, относящиеся к приложению, например целое число или указатель на другие данные, связанные с свойством. Значение по умолчанию равно 0.

CMFCPropertyGridColorProperty::EnableAutomaticButton

Включает автоматическую кнопку в диалоговом окне выбора цвета. (Стандартная автоматическая кнопка помечена Автоматически.)

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

Параметры

lpszLabel
[in] Текст метки автоматической кнопки.

colorAutomatic
[in] Значение цвета RGB автоматического (по умолчанию).

bEnable
[in] ЗНАЧЕНИЕ TRUE для включения автоматической кнопки; в противном случае — ЗНАЧЕНИЕ FALSE. Значение по умолчанию — TRUE.

Замечания

CMFCPropertyGridColorProperty::EnableOtherButton

Включает другую кнопку в диалоговом окне выбора цвета. (Стандартная другая кнопка помечена Дополнительные цвета.)

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg = TRUE,
    BOOL bEnable = TRUE);

Параметры

lpszLabel
[in] Текст метки другой кнопки.

bAltColorDlg
[in] ЗНАЧЕНИЕ TRUE для отображения диалогового CMFCColorDialog окна; Значение FALSE для отображения диалогового окна выбора стандартного цвета. Значение по умолчанию — TRUE.

bEnable
[in] ЗНАЧЕНИЕ TRUE для отображения другой кнопки; в противном случае — ЗНАЧЕНИЕ FALSE. Значение по умолчанию — TRUE.

Замечания

CMFCPropertyGridColorProperty::GetColor

Возвращает текущий цвет свойства.

COLORREF GetColor() const;

Возвращаемое значение

Значение цвета RGB.

Замечания

CMFCPropertyGridColorProperty::SetColor

Задает новый цвет свойства.

void SetColor(COLORREF color);

Параметры

color
[in] Значение цвета RGB.

Замечания

CMFCPropertyGridColorProperty::SetColumnsNumber

Задает число столбцов в текущей таблице свойств цвета.

void SetColumnsNumber(int nColumnsNumber);

Параметры

nColumnsNumber
[in] Предпочтительное количество столбцов в сетке свойств цвета.

Замечания

Этот метод задает значение защищенного m_nColumnsNumber элемента данных.

CMFCPropertyGridColorProperty::SetOriginalValue

Задает изменяемому свойству изначальное значение.

virtual void SetOriginalValue(const COleVariant& varValue);

Параметры

varValue
[in] Значение.

Замечания

Используйте метод CMFCPropertyGridProperty::ResetOriginalValue, чтобы сбросить исходное значение измененного свойства.

См. также

Диаграмма иерархии
Классы
Класс CMFCPropertyGridCtrl
Класс CMFCPropertyGridProperty