Класс 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);
Иерархия наследования
Требования
Заголовок: 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