Класс CMFCPropertyGridCtrl

Дополнительные сведения см. в исходном коде, расположенном в папке mfc установки Visual Studio. Например, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Поддерживает изменение элемента управления сетки свойств, который может отображать свойства в алфавитном или иерархическом порядке.

Синтаксис

class CMFCPropertyGridCtrl : public CWnd

Участники

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

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

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

Имя	Описание
CMFCPropertyGridCtrl::accHitTest	Вызывается платформой для извлечения дочернего элемента или дочернего объекта в заданной точке экрана. (Переопределяет CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Вызывается платформой для получения текущего положения указанного объекта на экране. (Переопределяет CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Вызывается платформой для изменения выбранной области или перемещения фокуса клавиатурного ввода указанного объекта. (Переопределяет CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Добавляет новое свойство в элемент управления сеткой свойств.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Закрывает диалоговое окно выбора цвета.
CMFCPropertyGridCtrl::Create	Создает элемент управления сетки свойств и присоединяет его к объекту элемента управления сеткой свойств.
CMFCPropertyGridCtrl::DeleteProperty	Удаляет указанное свойство из элемента управления сетки свойств.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Включает или отключает область описания, отображаемую под списком свойств.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Включает или отключает элемент управления заголовком в верхней части элемента управления сетки свойств.
CMFCPropertyGridCtrl::EnsureVisible	Прокручивает элемент управления сеткой свойств и развертывает элементы свойств до тех пор, пока указанное свойство не будет видно.
CMFCPropertyGridCtrl::ExpandAll	Развертывает или сворачивает все узлы управления сеткой свойств.
CMFCPropertyGridCtrl::FindItemByData	Извлекает свойство, связанное с определяемым DWORD пользователем значением.
CMFCPropertyGridCtrl::get_accChild	Вызывается платформой для извлечения адреса интерфейса IDispatch для указанного дочернего элемента. (Переопределяет CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Вызывается платформой для извлечения количества дочерних элементов, принадлежащих этому объекту. (Переопределяет CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Вызывается платформой для извлечения строки, описывающей действие объекта по умолчанию. (Переопределяет CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Вызывается платформой для извлечения строки, описывающей внешний вид указанного объекта. (Переопределяет CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Вызывается платформой для извлечения объекта, имеющего фокус клавиатурного ввода. (Переопределяет CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Вызывается платформой для получения строки свойства объекта Help . (Переопределяет CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Вызывается платформой для извлечения полного пути файла WinHelp, связанного с указанным объектом и идентификатором нужного раздела в файле. (Переопределяет CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Вызывается платформой для извлечения сочетания клавиш указанного объекта или клавиши доступа к нему. (Переопределяет CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Вызывается платформой для извлечения имени указанного объекта. (Переопределяет CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Вызывается платформой для извлечения информации, описывающей роль указанного объекта. (Переопределяет CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Вызывается платформой для извлечения выбранного дочернего элемента этого объекта. (Переопределяет CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Вызывается платформой для извлечения текущего состояния указанного объекта. (Переопределяет CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	Вызывается платформой для извлечения значения указанного объекта. (Переопределяет CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Извлекает цвет фона текущего элемента управления сетки свойств.
CMFCPropertyGridCtrl::GetBoldFont	Извлекает шрифт Windows из текста в текущем элементе управления сетки свойств полужирным шрифтом.
CMFCPropertyGridCtrl::GetCurSel	Извлекает выбранное в данный момент свойство.
CMFCPropertyGridCtrl::GetCustomColors	Извлекает настраиваемые цвета, которые в настоящее время определены для элементов управления сеткой свойств.
CMFCPropertyGridCtrl::GetDescriptionHeight	Извлекает высоту области описания, расположенной в нижней части элемента управления сетки свойств.
CMFCPropertyGridCtrl::GetDescriptionRows	Извлекает количество строк в области описания текущего элемента управления сетки свойств.
CMFCPropertyGridCtrl::GetHeaderCtrl	Извлекает внутренний CMFCHeaderCtrl объект, который платформа использует для отображения текущего элемента управления сеткой свойств.
CMFCPropertyGridCtrl::GetHeaderHeight	Извлекает высоту заголовка элемента управления сеткой свойств.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Извлекает ширину левого столбца текущего элемента управления сетки свойств, содержащего имя каждого свойства.
CMFCPropertyGridCtrl::GetListRect	Извлекает ограничивающий прямоугольник элемента управления сетки свойств.
CMFCPropertyGridCtrl::GetProperty	Извлекает указатель на объект свойства, соответствующий указанному индексу элемента управления сеткой свойств.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Извлекает текущую ширину столбца, содержащего значения свойств.
CMFCPropertyGridCtrl::GetPropertyCount	Извлекает количество свойств в элементе управления сеткой свойств.
CMFCPropertyGridCtrl::GetRowHeight	Извлекает высоту строки в элементе управления сеткой свойств.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Извлекает указатель на элемент управления полосы прокрутки в элементе управления сетки свойств. (Переопределяет CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Извлекает цвет текста элементов свойств в текущем элементе управления сетки свойств.
CMFCPropertyGridCtrl::GetThisClass	Используется платформой для получения указателя на CRuntimeClass объект, связанный с этим типом класса.
CMFCPropertyGridCtrl::HitTest	Извлекает указатель на объект свойства, соответствующий элементу элемента управления сетки свойств, если указанная точка находится в элементе. Этот метод также указывает область в элементе управления сетки свойств, который содержит точку.
CMFCPropertyGridCtrl::InitHeader	Инициализирует внутренний CMFCHeaderCtrl объект, который платформа использует для отображения текущего элемента управления сетки свойств.
CMFCPropertyGridCtrl::IsAlphabeticMode	Указывает, находится ли элемент управления сеткой свойств в алфавитном режиме.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Указывает, отображается ли область описания элемента управления сетки свойств.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Указывает, отображается ли каждое имя группы свойств по ширине текущего элемента управления сетки свойств.
CMFCPropertyGridCtrl::IsHeaderCtrl	Указывает, отображается ли элемент управления заголовком.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Указывает, как элемент управления сеткой свойств отображает измененные свойства.
CMFCPropertyGridCtrl::IsShowDragContext	Указывает, перерисовывает ли платформа столбцы имен и значений текущего элемента управления сетки свойств при изменении размера столбцов пользователем.
CMFCPropertyGridCtrl::IsVSDotNetLook	Указывает, находится ли внешний вид элемента управления сеткой свойств в стиле, используемом VS .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Указывает, как отображать измененные свойства.
CMFCPropertyGridCtrl::PreTranslateMessage	Используется классом CWinApp для перевода сообщений окна перед отправкой в TranslateMessage функции Windows и DispatchMessage Windows. (Переопределяет CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Удаляет все объекты свойств из элемента управления сеткой свойств.
CMFCPropertyGridCtrl::ResetOriginalValues	Восстанавливает исходное значение всех свойств.
CMFCPropertyGridCtrl::SetAlphabeticMode	Задает или сбрасывает алфавитный режим.
CMFCPropertyGridCtrl::SetBoolLabels	Задает текст логических меток.
CMFCPropertyGridCtrl::SetCurSel	Выбирает свойство в элементе управления сеткой свойств.
CMFCPropertyGridCtrl::SetCustomColors	Задает настраиваемые цвета для различных элементов элемента управления сеткой свойств.
CMFCPropertyGridCtrl::SetDescriptionRows	Указывает количество строк, отображаемых в разделе описания текущего элемента управления сетки свойств.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Указывает, следует ли отображать полную ширину имени категории для группы свойств в текущем элементе управления сетки свойств.
CMFCPropertyGridCtrl::SetListDelimiter	Определяет символ, который будет использоваться в качестве разделителя в списке значений свойств.
CMFCPropertyGridCtrl::SetShowDragContext	Указывает, перерисовывает ли платформа столбцы имен и значений текущего элемента управления сетки свойств при изменении размера столбцов пользователем.
CMFCPropertyGridCtrl::SetVSDotNetLook	Задает внешний вид элемента управления сетки свойств стилем, используемым в VS .NET.
CMFCPropertyGridCtrl::UpdateColor	Задает значение цвета текущего выбранного свойства цвета.

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

Имя	Описание
CMFCPropertyGridCtrl::AdjustLayout	Перерисовывает элемент управления сетки свойств и его свойства.
CMFCPropertyGridCtrl::CompareProps	Вызывается элементом управления сетки свойств для сортировки свойств.
CMFCPropertyGridCtrl::EditItem	Вызывается платформой, когда пользователь начинает изменять свойство.
CMFCPropertyGridCtrl::EndEditItem	Вызывается платформой, когда пользователь перестает изменять свойство.
CMFCPropertyGridCtrl::Init	Вызывается платформой для инициализации элемента управления сеткой свойств.
CMFCPropertyGridCtrl::OnChangeSelection	Вызывается платформой при изменении текущего выбора.
CMFCPropertyGridCtrl::OnClickButton	Вызывается платформой при нажатии кнопки свойства.
CMFCPropertyGridCtrl::OnDrawBorder	Вызывается платформой для рисования границы вокруг элемента управления сеткой свойств.
CMFCPropertyGridCtrl::OnDrawDescription	Вызывается платформой для рисования области описания и отображения текста описания.
CMFCPropertyGridCtrl::OnDrawList	Вызывается платформой для отображения списка свойств в элементе управления сеткой свойств.
CMFCPropertyGridCtrl::OnDrawProperty	Вызывается платформой для отображения свойства.
CMFCPropertyGridCtrl::OnPropertyChanged	Вызывается платформой при изменении значения свойства.
CMFCPropertyGridCtrl::OnSelectCombo	Вызывается платформой при выборе свойства, содержащего элемент управления со списком.
CMFCPropertyGridCtrl::ValidateItemData	Вызывается платформой для проверки данных свойств.

Замечания

Класс CMFCPropertyGridCtrl отображает элемент управления сеткой свойств, содержащий редактируемые свойства, производные CMFCPropertyGridProperty от класса. Каждое свойство может представлять тип и может содержать вложенные элементы. Элемент управления сеткой свойств поддерживает область с изменением размера в нижней части, которая может отображать описание выбранного свойства.

Чтобы использовать элемент управления сеткой CMFCPropertyGridCtrl свойств, создайте объект и вызовите CMFCPropertyGridCtrl::Create метод. CMFCPropertyGridCtrl::AddProperty Используйте метод для добавления свойств в список.

Свойства выбора

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

В следующей таблице перечислены четыре типа свойств выбора:

Класс	Description
CMFCPropertyGridProperty Класс	Свойство общего назначения, используемое для указания значения строк, логических значений, дат и т. д.
CMFCPropertyGridColorProperty Класс	Свойство, используемое для выбора значения цвета.
CMFCPropertyGridFileProperty Класс	Свойство, используемое для выбора файла.
CMFCPropertyGridFontProperty Класс	Свойство, используемое для выбора шрифта.

Иллюстрации

На следующих рисунках показан элемент управления сеткой свойств, который отображает свойства двумя способами. Первый рисунок отображает свойства иерархически и второй отображает свойства в алфавитном порядке.

Пример

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

CMFCPropertyGridCtrl m_wndPropList;

m_wndPropList.EnableHeaderCtrl();
m_wndPropList.EnableDescriptionArea();
m_wndPropList.SetVSDotNetLook(m_bDotNetLook);
// BOOL m_bMarkChanged
m_wndPropList.MarkModifiedProperties(m_bMarkChanged);
// BOOL m_bPropListCategorized
m_wndPropList.SetAlphabeticMode(!m_bPropListCategorized);
// BOOL m_bShowDragContext
m_wndPropList.SetShowDragContext(m_bShowDragContext);

// BOOL m_bMarkSortedColumn
m_wndList.EnableMarkSortedColumn(m_bMarkSortedColumn);

// BOOL m_bPropListCustomColors
// set custom colors for various elements of the property grid control
if (m_bPropListCustomColors)
{
   m_wndPropList.SetCustomColors(RGB(228, 243, 254), RGB(46, 70, 165), RGB(200, 236, 209), RGB(33, 102, 49), RGB(255, 229, 216), RGB(128, 0, 0), RGB(159, 159, 255));
}
else
{
   COLORREF c = (COLORREF)-1;
   m_wndPropList.SetCustomColors(c, c, c, c, c, c, c);
}

m_wndPropList.RedrawWindow();

// restore original values of the properties
m_wndPropList.ResetOriginalValues();

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

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Требования

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

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Параметры

[входной] flagsSelect
[входной] varChild\

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

Замечания

CMFCPropertyGridCtrl::AddProperty

Добавляет новое свойство в элемент управления сеткой свойств.

int AddProperty(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Параметры

pProp
[in] Указатель на свойство.

bRedraw
[in] TRUE для немедленного перерасхода свойства; FALSEв противном случае . Значение по умолчанию — TRUE.

bAdjustLayout
[in] TRUE для перерасчета рисования текста и значения свойства, а затем рисования свойства; FALSE для использования существующих вычислений для рисования свойства. Значение по умолчанию — TRUE.

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

Если этот метод выполнен успешно, отсчитываемый от нуля индекс позиции в элементе управления сеткой свойств, где добавляется свойство; в противном случае — значение -1.

Замечания

Этот метод добавляет указатель на указанное свойство в конец списка свойств в элементе управления сеткой свойств. Не уничтожайте свойства или не позволяйте им выйти из области до уничтожения элемента управления сеткой. После завершения работы с элементом управления сеткой свойств вызовите CMFCPropertyGridCtrl::RemoveAll удаление всех добавленных свойств. Метод AddProperty завершается ошибкой, если указанное свойство уже добавлено в список.

CMFCPropertyGridCtrl::AdjustLayout

Перерисовывает элемент управления сетки свойств и его свойства.

virtual void AdjustLayout();

Замечания

Этот метод пересчитывает способ рисования всего элемента управления сетки свойств и его свойств, включая изображения, шрифты и элементы управления.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Параметры

[входной] bShow\

Замечания

CMFCPropertyGridCtrl::CloseColorPopup

Закрывает диалоговое окно выбора цвета.

virtual void CloseColorPopup();

Замечания

Дополнительные сведения о диалоговом окне выбора цвета см. в разделе CMFCPropertyGridColorProperty "Класс".

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

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

CMFCPropertyGridCtrl();

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

Замечания

CMFCPropertyGridCtrl::CompareProps

Вызывается элементом управления сетки свойств для сортировки свойств.

virtual int CompareProps(
    const CMFCPropertyGridProperty* pProp1,
    const CMFCPropertyGridProperty* pProp2) const;

Параметры

pProp1
Указатель на свойство.

pProp2
Указатель на свойство.

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

Возвращаемое значение	Description
< 0	Имя pProp1 параметра меньше имени pProp2 параметра.
0	Имя pProp1 параметра равно имени pProp2 параметра.
> 0	Имя pProp1 объекта больше имени pProp2 параметра.

Замечания

По умолчанию этот метод использует CString::Compare метод для сравнения CMFCPropertyGridProperty::m_strName элементов указанных параметров.

CMFCPropertyGridCtrl::Create

Создает элемент управления сетки свойств и присоединяет его к объекту элемента управления сеткой свойств.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Параметры

dwStyle
[in] Побитовое сочетание "или" (|) стилей окон.

rect
[in] Ограничивающий прямоугольник, указывающий размер и положение окна в координатах pParentWndклиента.

pParentWnd
[in] Указатель на родительское окно. Значение не должно быть равно NULL.

nID
[in] Идентификатор дочернего окна.

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

TRUE Значение FALSEв противном случае .

Замечания

Чтобы создать элемент управления сеткой свойств, сначала вызовите CMFCPropertyGridCtrl::CMFCPropertyGridCtrl создание объекта сетки свойств. Затем вызовите CMFCPropertyGridCtrl::Create.

Пример

В следующем примере показано, как использовать Create метод в CMFCPropertyGridCtrl классе. Этот пример является частью примера "Новые элементы управления".

// CRect rectPropList
// CMFCPropertyGridCtrl m_wndPropList
// The this pointer points to a CPage5 class which extends the CMFCPropertyPage class.
m_wndPropList.Create(WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER, rectPropList, this, (UINT)-1);

CMFCPropertyGridCtrl::DeleteProperty

Удаляет указанное свойство из элемента управления сетки свойств.

BOOL DeleteProperty(
    CMFCPropertyGridProperty*& pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Параметры

pProp
[in] Указатель на свойство.

bRedraw
[in] TRUE Для повторного создания элемента управления сеткой свойств; FALSEв противном случае . Значение по умолчанию — TRUE.

bAdjustLayout
[in] TRUE чтобы пересчитать, как нарисовать весь текст, изображения и элементы в элементе управления сеткой свойств, а затем нарисовать элемент управления; FALSEв противном случае . Значение по умолчанию — TRUE.

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

TRUE Значение , если этот метод выполнен успешно; FALSEв противном случае .

Замечания

Используйте этот метод для удаления свойства и всех вложенных элементов из элемента управления сетки свойств.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

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

Замечания

CMFCPropertyGridCtrl::EditItem

Вызывается платформой, когда пользователь начинает изменять свойство.

virtual BOOL EditItem(
    CMFCPropertyGridProperty* pProp,
    LPPOINT lptClick=NULL);

Параметры

pProp
[in] Указатель на свойство.

lptClick
[in] Точка в элементе управления сеткой свойств, который пользователь щелкнул, чтобы начать операцию редактирования. Точка находится в координатах клиента элемента управления. Значение по умолчанию — NULL.

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

TRUE Значение , если метод выполнен успешно; FALSEв противном случае .

Замечания

CMFCPropertyGridCtrl::EnableDescriptionArea

Включает или отключает область описания, отображаемую под списком свойств в элементе управления сеткой свойств.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Параметры

bEnable
[in] TRUE включение области описания; FALSE чтобы отключить область описания. Значение по умолчанию — TRUE.

Замечания

Область описания отображается в нижней части элемента управления сетки свойств. По умолчанию область описания отключена и не отображается.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Включает или отключает элемент управления заголовком в верхней части элемента управления сетки свойств.

void EnableHeaderCtrl(
    BOOL bEnable=TRUE,
    LPCTSTR lpszLeftColumn=_T("Property"),
    LPCTSTR lpszRightColumn=_T("Value"));

Параметры

bEnable
[in] TRUE для включения элемента управления заголовком; FALSE , чтобы отключить элемент управления заголовком. Значение по умолчанию — TRUE.

lpszLeftColumn
[in] Заголовок левого столбца элемента управления заголовком. Значение по умолчанию — Property.

lpszRightColumn
[in] Заголовок правого столбца элемента управления заголовком. Значение по умолчанию — Value.

CMFCPropertyGridCtrl::EndEditItem

Вызывается платформой, когда пользователь завершает изменение свойства.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Параметры

bUpdateData
[in] TRUE чтобы указать, что измененные данные свойства должны быть проверены при завершении операции редактирования; FALSEв противном случае . Значение по умолчанию — TRUE.

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

TRUE Значение , если операция редактирования завершается успешно; FALSE Значение , если измененные данные свойства недопустимы или если операция редактирования должна продолжаться.

Замечания

CMFCPropertyGridCtrl::EnsureVisible

Прокручивает элемент управления сеткой свойств и развертывает элементы свойств до тех пор, пока указанное свойство не будет видно.

void EnsureVisible(
    CMFCPropertyGridProperty* pProp,
    BOOL bExpandParents=FALSE);

Параметры

pProp
[in] Указатель на свойство.

bExpandParents
[in] TRUE , чтобы развернуть родительские элементы, чтобы сделать указанное свойство видимым; FALSEв противном случае . Значение по умолчанию — FALSE.

Замечания

CMFCPropertyGridCtrl::ExpandAll

Развертывает или сворачивает все узлы управления сеткой свойств.

void ExpandAll(BOOL bExpand=TRUE);

Параметры

bExpand
[in] TRUE , чтобы развернуть все узлы; FALSE чтобы свернуть все узлы. Значение по умолчанию — TRUE.

Замечания

CMFCPropertyGridCtrl::FindItemByData

Извлекает свойство, связанное с определяемым DWORD пользователем значением.

CMFCPropertyGridProperty* FindItemByData(
    DWORD_PTR dwData,
    BOOL bSearchSubItems=TRUE) const;

Параметры

dwData
[in] DWORD Значение.

bSearchSubItems
[in] TRUE для поиска вложенных элементов свойства; FALSEв противном случае . Значение по умолчанию — TRUE.

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

Указатель на связанный объект свойства, если этот метод выполнен успешно; NULLв противном случае .

Замечания

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl Используйте конструктор или CMFCPropertyGridProperty::SetData метод для связывания DWORD с свойством.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Параметры

[входной] pcountChildren\

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

Замечания

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Параметры

[входной] pvarChild\

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

Замечания

CMFCPropertyGridCtrl::get_accHelp

virtual HRESULT get_accHelp(
    VARIANT varChild,
    BSTR* pszHelp);

Параметры

[входной] varChild
[входной] pszHelp\

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

Замечания

CMFCPropertyGridCtrl::get_accHelpTopic

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Параметры

[входной] pszHelpFile
[входной] varChild
[входной] pidTopic\

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

Замечания

CMFCPropertyGridCtrl::get_accKeyboardShortcut

virtual HRESULT get_accKeyboardShortcut(
    VARIANT varChild,
    BSTR* pszKeyboardShortcut);

Параметры

[входной] varChild
[входной] pszKeyboardShortcut\

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

Замечания

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Параметры

[входной] pvarChildren\

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

Замечания

CMFCPropertyGridCtrl::GetBkColor

Извлекает цвет фона текущего элемента управления сетки свойств.

COLORREF GetBkColor() const;

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

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

Замечания

Этот метод извлекает цвет, который платформа использует для рисования фона текущего элемента управления сетки свойств. Метод CMFCPropertyGridCtrl::GetTextColor получает цвет переднего плана.

CMFCPropertyGridCtrl::GetBoldFont

Извлекает шрифт Windows, используемый для рисования текста в текущем элементе управления сетки свойств в полужирном стиле.

CFont& GetBoldFont();

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

Ссылка на CFont объект, описывающий характеристики полужирного шрифта.

CMFCPropertyGridCtrl::GetCurSel

Извлекает выбранное в данный момент свойство.

CMFCPropertyGridProperty* GetCurSel() const;

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

Указатель на объект свойства, соответствующий выбранному элементу в элементе управления сетки свойств.

Замечания

CMFCPropertyGridCtrl::GetCustomColors

Извлекает настраиваемые цвета, которые в настоящее время определены для элементов управления сеткой свойств.

void GetCustomColors(
    COLORREF& clrBackground,
    COLORREF& clrText,
    COLORREF& clrGroupBackground,
    COLORREF& clrGroupText,
    COLORREF& clrDescriptionBackground,
    COLORREF& clrDescriptionText,
    COLORREF& clrLine);

Параметры

clrBackground
[out] Цвет фона значений свойств.

clrText
[out] Цвет имен свойств и текста значения свойства.

clrGroupBackground
[out] Цвет фона группы свойств.

clrGroupText
[out] Цвет текста в группе свойств.

clrDescriptionBackground
[out] Цвет фона области описания.

clrDescriptionText
[out] Цвет текста в области описания.

clrLine
[out] Цвет линий, которые рисуются между свойствами.

Замечания

CMFCPropertyGridCtrl::SetCustomColors Используйте метод для задания пользовательских цветов.

CMFCPropertyGridCtrl::GetDescriptionHeight

Извлекает высоту области описания, расположенную в нижней части элемента управления сетки свойств.

int GetDescriptionHeight() const;

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

Высота области описания в пикселях.

Замечания

Высота области описания вычисляется автоматически и имеет значение 1/4 высоты элемента управления сеткой свойств.

CMFCPropertyGridCtrl::EnableDescriptionArea Используйте метод для отображения или скрытия области описания. CMFCPropertyGridCtrl::IsDescriptionArea Используйте метод, чтобы определить, отображается ли область описания или скрыта.

CMFCPropertyGridCtrl::GetDescriptionRows

Извлекает количество строк в области описания текущего элемента управления сетки свойств.

int GetDescriptionRows() const;

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

Количество строк в области описания текущего элемента управления сетки свойств.

Замечания

Конструктор CMFCPropertyGridCtrl::CMFCPropertyGridCtrl инициализирует область описания до 3 строк.

CMFCPropertyGridCtrl::GetHeaderCtrl

Извлекает внутренний CMFCHeaderCtrl объект, который платформа использует для отображения текущего элемента управления сеткой свойств.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

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

Ссылка на объект CMFCHeaderCtrl.

CMFCPropertyGridCtrl::GetHeaderHeight

Извлекает высоту заголовка элемента управления сетки свойств.

int GetHeaderHeight() const;

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

Высота заголовка в пикселях.

Замечания

CMFCPropertyGridCtrl::GetLeftColumnWidth

Извлекает ширину левого столбца текущего элемента управления сетки свойств, содержащего имя каждого свойства.

int GetLeftColumnWidth() const;

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

Ширина столбца имени.

Замечания

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

CMFCPropertyGridCtrl::GetListRect

Извлекает ограничивающий прямоугольник элемента управления сетки свойств.

CRect GetListRect() const;

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

Ограничивающий прямоугольник элемента управления сетки свойств. Этот прямоугольник не включает область описания и заголовок.

Замечания

CMFCPropertyGridCtrl::GetProperty

Извлекает указатель на объект свойства, соответствующий указанному индексу элемента в элементе управления сетки свойств.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Параметры

nIndex
[in] Отсчитываемый от нуля индекс элемента управления сеткой свойств.

Этот метод утверждает, что nIndex параметр меньше нуля или больше или равен количеству свойств.

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

Указатель на объект свойства, соответствующий указанному индексу, если этот метод выполнен успешно; NULLв противном случае .

Замечания

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Извлекает текущую ширину столбца, содержащего значения свойств.

int GetPropertyColumnWidth() const;

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

Текущая ширина столбца, содержащего значения свойств.

Замечания

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

CMFCPropertyGridCtrl::GetPropertyCount

Извлекает количество свойств в элементе управления сеткой свойств.

int GetPropertyCount() const;

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

Количество свойств.

Замечания

CMFCPropertyGridCtrl::GetRowHeight

Извлекает высоту строки в элементе управления сеткой свойств.

int GetRowHeight() const;

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

Высота строки.

Замечания

Высота строки равна текущей высоте шрифта плюс 4 пикселя.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Извлекает указатель на элемент управления полосы прокрутки в элементе управления сетки свойств.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Параметры

nBar
[in] Ориентация полосы прокрутки, которая должна быть SB_VERT.

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

Указатель на объект полосы прокрутки или если нет полосы прокрутки или NULL ориентация SB_HORZполосы прокрутки.

Замечания

Используйте этот метод, чтобы получить прямой доступ к элементу управления вертикальной полосы прокрутки.

CMFCPropertyGridCtrl::GetTextColor

Извлекает цвет, используемый для рисования текста элементов свойства в текущем элементе управления сетки свойств.

COLORREF GetTextColor() const;

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

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

Замечания

Этот метод извлекает цвет, который платформа использует для рисования переднего плана текущего элемента управления сетки свойств. Метод CMFCPropertyGridCtrl::GetBkColor извлекает цвет фона.

CMFCPropertyGridCtrl::HitTest

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

CMFCPropertyGridProperty* HitTest(
    CPoint pt,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
    BOOL bPropsOnly=FALSE) const;

Параметры

pt
[in] Точка в координатах клиента.

pnArea
[in, out] Указатель на ClickArea переменную. При возврате этого метода переменная указывает область свойств, содержащую указанную точку. Дополнительные сведения о области свойств см. в примечаниях.

bPropsOnly
[in] TRUE для проверки только области свойств; FALSE для проверки области описания, если указанная точка не находится в области свойств. Значение по умолчанию — FALSE. Дополнительные сведения о области описания см. в разделе "Примечания".

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

bPropsOnly Если параметр и TRUE указанная точка находится в области свойства, возвращаемое значение является указателем на соответствующий объект свойства. Кроме того, pnArea параметр имеет определенную область, содержащую указанную точку. В противном случае возвращаемое значение равно NULL и pnArea параметр не изменяется.

bPropsOnly Если параметр имеет значениеFALSE, возвращаемое значение всегдаNULL. Однако если указанная точка находится в области описания, pnArea параметр имеет значение CMFCPropertyGridProperty::ClickDescription.

Замечания

Область свойств термина относится к любому из имен, значений или разверните области элемента управления сеткой свойств. Область описания — это зона в нижней части элемента управления сетки свойств. При выборе элемента управления сеткой свойств область описания отображает описание соответствующего свойства.

Этот метод задает значение переменной, на которую pnArea указывает параметр. В следующей таблице перечислены возможные значения и соответствующие области.

Значение	Площадь
ClickArea::ClickExpandBox	Элемент управления "Расширение свойства".
ClickArea::ClickName	Имя свойства.
ClickArea::ClickValue	Значение свойства.
CMFCPropertyGridProperty::ClickDescription	Область описания элемента управления сеткой свойств.

CMFCPropertyGridCtrl::Init

Вызывается платформой для инициализации элемента управления сеткой свойств.

virtual void Init();

Замечания

CMFCPropertyGridCtrl::InitHeader

Инициализирует внутренний CMFCHeaderCtrl объект, который платформа использует для отображения текущего элемента управления сетки свойств.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Указывает, находится ли элемент управления сеткой свойств в алфавитном режиме.

BOOL IsAlphabeticMode() const;

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

TRUE Значение , если элемент управления сеткой свойств находится в алфавитном режиме; в противном случае FALSE.

Замечания

Если элемент управления сеткой свойств находится в алфавитном режиме, все свойства сортируются по алфавиту по их именам. В противном случае свойства группируются под родительскими узлами.

CMFCPropertyGridCtrl::SetAlphabeticMode Используйте метод, чтобы включить или отключить алфавитный режим.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

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

Замечания

CMFCPropertyGridCtrl::IsDescriptionArea

Указывает, отображается ли область описания элемента управления сетки свойств.

BOOL IsDescriptionArea() const;

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

TRUE Значение FALSEв противном случае .

Замечания

CMFCPropertyGridCtrl::EnableDescriptionArea Используйте метод для скрытия или отображения области описания.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

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

BOOL IsGroupNameFullWidth() const;

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

TRUE Значение , если имена групп отображаются по ширине элемента управления сеткой свойств; FALSE Значение , если имена групп усечены правым (значением) элемента управления.

Замечания

Группа — это коллекция связанных свойств в элементе управления сеткой свойств. Если элемент управления отображается иерархически, имя группы отображается как название категории в строке над группой.

CMFCPropertyGridCtrl::IsHeaderCtrl

Указывает, отображается ли элемент управления заголовком.

BOOL IsHeaderCtrl() const;

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

TRUE Значение , если элемент управления заголовком отображается; в противном случае FALSE.

Замечания

CMFCPropertyGridCtrl::EnableHeaderCtrl Используйте метод для скрытия или отображения элемента управления заголовком.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Указывает, как элемент управления сеткой свойств отображает измененные свойства.

BOOL IsMarkModifiedProperties() const;

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

TRUE Значение , если полужирный стиль используется для отображения измененных свойств; FALSE Если для отображения измененных свойств используется обычный стиль.

Замечания

CMFCPropertyGridCtrl::IsShowDragContext

Указывает, перерисовывает ли платформа столбцы имен и значений текущего элемента управления сетки свойств при изменении размера столбцов пользователем.

BOOL IsShowDragContext() const;

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

TRUE Значение , если платформа перерисовывает столбцы имени и значения во время операции изменения размера; FALSE Если платформа перерисовывает столбцы после завершения операции перетаскивания.

Замечания

Пользователь может изменить размер столбцов имени и значения элемента управления сеткой свойств, перетащив разделимую полосу между столбцами. Если отображается контекст перетаскивания, столбцы имени и значения будут изменены, пока пользователь перетаскивает разделимую панель. В противном случае разделенная полоса перемещается, но столбцы не удаляются до завершения операции перетаскивания.

CMFCPropertyGridCtrl::IsVSDotNetLook

Указывает, находится ли внешний вид элемента управления сеткой свойств в стиле Visual Studio .NET.

BOOL IsVSDotNetLook() const;

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

TRUE Значение , если элемент управления сеткой свойств находится в стиле Visual Studio .NET; FALSEв противном случае .

Замечания

CMFCPropertyGridCtrl::SetVSDotNetLook Используйте метод, чтобы задать элемент управления сеткой свойств в стиле Visual Studio .NET.

CMFCPropertyGridCtrl::MarkModifiedProperties

Указывает, как отображать измененные свойства.

void MarkModifiedProperties(
    BOOL bMark=TRUE,
    BOOL bRedraw=TRUE);

Параметры

bMark
[in] TRUE отображение измененных свойств в полужирном стиле; FALSE для отображения измененных свойств в регулярном стиле. Значение по умолчанию — TRUE.

bRedraw
[in] TRUE Для немедленного перерисовки элемента управления сетки свойств; FALSEв противном случае . Значение по умолчанию — TRUE.

Замечания

CMFCPropertyGridCtrl::OnChangeSelection

Вызывается платформой при изменении текущего выбора.

virtual void OnChangeSelection(
    CMFCPropertyGridProperty* pNewSel,
    CMFCPropertyGridProperty* pOldSel);

Параметры

pNewSel
[in] Указатель на только что выбранное свойство.

pOldSel
[in] Указатель на ранее выбранное свойство.

Замечания

Реализация этого метода по умолчанию ничего не делает.

CMFCPropertyGridCtrl::OnClickButton

Вызывается платформой при нажатии кнопки свойства.

virtual void OnClickButton(CPoint point);

Параметры

point
[in] Точка в координатах клиента.

Замечания

По умолчанию этот метод обновляет текущее значение свойства.

CMFCPropertyGridCtrl::OnDrawBorder

Вызывается платформой для рисования границы вокруг элемента управления сеткой свойств.

virtual void OnDrawBorder(CDC* pDC);

Параметры

pDC
[in] Указатель на контекст устройства.

Замечания

CMFCPropertyGridCtrl::OnDrawDescription

Вызывается платформой для рисования области описания и отображения текста описания.

virtual void OnDrawDescription(
    CDC* pDC,
    CRect rect);

Параметры

pDC
[in] Указатель на контекст устройства.

rect
[in] Прямоугольник, указывающий место рисования области описания.

Замечания

CMFCPropertyGridCtrl::EnableDescriptionArea Используйте метод для отображения области описания.

CMFCPropertyGridCtrl::OnDrawList

Вызывается платформой для отображения списка свойств в элементе управления сеткой свойств.

virtual void OnDrawList(CDC* pDC);

Параметры

pDC
[in] Указатель на контекст устройства.

Замечания

CMFCPropertyGridCtrl::OnDrawProperty

Вызывается платформой для отображения свойства.

virtual int OnDrawProperty(
    CDC* pDC,
    CMFCPropertyGridProperty* pProp) const;

Параметры

pDC
[in] Указатель на контекст устройства.

pProp
[in] Указатель на объект свойства.

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

TRUE Значение , если этот метод выполнен успешно; FALSEв противном случае .

Замечания

CMFCPropertyGridCtrl::OnPropertyChanged

Вызывается платформой при изменении значения свойства.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Параметры

pProp
[in] Указатель на объект свойства, значение которого изменилось.

Замечания

По умолчанию этот метод отправляет AFX_WM_PROPERTY_CHANGED сообщение владельцу элемента управления сетки свойств.

CMFCPropertyGridCtrl::OnSelectCombo

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

void OnSelectCombo();

Замечания

CMFCPropertyGridCtrl::RemoveAll

Удаляет все объекты свойств из элемента управления сеткой свойств.

void RemoveAll();

Замечания

CMFCPropertyGridCtrl::ResetOriginalValues

Восстанавливает исходные значения всех свойств.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Параметры

bRedraw
[in] TRUE Для повторного создания списка свойств; FALSEв противном случае . Значение по умолчанию — TRUE.

Замечания

CMFCPropertyGridCtrl::SetAlphabeticMode

Задает или сбрасывает алфавитный режим.

void SetAlphabeticMode(BOOL bSet=TRUE);

Параметры

bSet
[in] TRUE для задания алфавитного режима; FALSE сброс алфавитного режима. Значение по умолчанию — TRUE.

Замечания

Если элемент управления сеткой свойств находится в алфавитном режиме, элемент управления сортирует все свойства, содержащиеся в нем по имени свойства.

CMFCPropertyGridCtrl::SetBoolLabels

Задает текст логических меток.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Параметры

lpszTrue
[in] Текстовая строка, отображаемая для логического значения true.

lpszFalse
[in] Текстовая строка, отображаемая для логического значения false.

Замечания

CMFCPropertyGridCtrl::SetCurSel

Выбирает свойство в элементе управления сеткой свойств.

void SetCurSel(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE);

Параметры

pProp
[in] Указатель на объект свойства.

bRedraw
[in] TRUE Для немедленного перерисовки элемента управления сетки свойств; FALSEв противном случае . Значение по умолчанию — TRUE.

Замечания

Используйте этот метод, чтобы отменить выбор текущего элемента в элементе управления сеткой свойств, а затем выбрать элемент, соответствующий указанному свойству.

CMFCPropertyGridCtrl::SetCustomColors

Задает настраиваемые цвета для различных элементов элемента управления сетки свойств.

void SetCustomColors(
    COLORREF clrBackground,
    COLORREF clrText,
    COLORREF clrGroupBackground,
    COLORREF clrGroupText,
    COLORREF clrDescriptionBackground,
    COLORREF clrDescriptionText,
    COLORREF clrLine);

Параметры

clrBackground
[in] Цвет фона значений свойств.

clrText
[in] Цвет имен свойств и текста значения свойства.

clrGroupBackground
[in] Цвет фона группы свойств.

clrGroupText
[in] Новый цвет текста группы свойств.

clrDescriptionBackground
[in] Цвет фона области описания.

clrDescriptionText
[in] Цвет текста в области описания.

clrLine
[in] Цвет линий, которые рисуются между свойствами.

Замечания

Для любого параметра укажите ((COLORREF)-1) значение цвета, используемое по умолчанию для этого элемента элемента управления сетки свойств.

Чтобы настроить внешний вид определенного свойства, наследуйте класс из CMFCPropertyGridProperty класса, а затем переопределите CMFCPropertyGridProperty::OnDrawNameметоды , CMFCPropertyGridProperty::OnDrawValueCMFCPropertyGridProperty::OnDrawExpandBoxи CMFCPropertyGridProperty::OnDrawButton методы.

CMFCPropertyGridCtrl::SetDescriptionRows

Указывает количество строк, отображаемых в разделе описания текущего элемента управления сетки свойств.

void SetDescriptionRows(int nDescRows);

Параметры

nDescRows
[in] Количество строк, отображаемых в описании свойства.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

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

void SetGroupNameFullWidth(
    BOOL bGroupNameFullWidth = TRUE,
    BOOL bRedraw = TRUE);

Параметры

bGroupNameFullWidth
[in] TRUE для отображения полной ширины имени категории независимо от ширины столбца имени свойства. FALSE Чтобы ограничить ширину имени категории шириной столбца имени свойства. Значение по умолчанию — TRUE.

bRedraw
[in] TRUE немедленное обновление элемента управления сеткой свойств; FALSE для обновления элемента управления при возникновении следующего события перерисовки. Значение по умолчанию — TRUE.

Замечания

Элемент управления сеткой свойств состоит из столбца имени свойства и столбца значения свойства. Конец столбца имени также является началом столбца значений. Чтобы изменить размер столбцов, перетащите границу между столбцами.

Имя группы терминов и имя категории используются взаимозаменяемо в этом методе. Имя категории отображается в строке, которая возглавляет набор связанных свойств и значений. Этот метод указывает, указана ли ширина столбца имени свойства также указывает ширину отображаемого имени категории.

CMFCPropertyGridCtrl::SetListDelimiter

Определяет символ, используемый в качестве разделителя в списке значений свойств.

void SetListDelimiter(TCHAR c);

Параметры

c
[in] Символ, который служит разделителем.

Замечания

Используйте этот метод для определения символа разделителя в списке значений свойств, используемых в конструкторе CMFCPropertyGridProperty::CMFCPropertyGridProperty . В этом конструкторе задайте bIsValueList для параметра TRUEзначение .

По умолчанию CMFCPropertyGridCtrl::CMFCPropertyGridCtrl конструктор задает символ разделителя запятой (',).

CMFCPropertyGridCtrl::SetShowDragContext

Указывает, перерисовывает ли платформа столбцы имен и значений текущего элемента управления сетки свойств при изменении размера столбцов пользователем.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Параметры

bShowDragContext
[in] TRUE для перераспродажи столбцов имени и значения во время операции изменения размера; FALSE Для повторного создания столбцов после завершения операции перетаскивания. Значение по умолчанию — TRUE.

Замечания

Пользователь может изменить размер столбцов имени и значения элемента управления сеткой свойств, перетащив разделимую полосу между столбцами. Если отображается контекст перетаскивания, столбцы имени и значения будут изменены, пока пользователь перетаскивает разделимую панель. В противном случае разделенная полоса перемещается, но столбцы не удаляются до завершения операции перетаскивания.

CMFCPropertyGridCtrl::SetVSDotNetLook

Задает внешний вид элемента управления сетки свойств стилем, используемым в Visual Studio .NET.

void SetVSDotNetLook(BOOL bSet=TRUE);

Параметры

bSet
[in] TRUE Чтобы задать элемент управления сеткой свойств в стиле, который используется в Visual Studio .NET; FALSEв противном случае . Значение по умолчанию — TRUE.

Замечания

CMFCPropertyGridCtrl::UpdateColor

Задает значение цвета текущего выбранного свойства цвета.

virtual void UpdateColor(COLORREF color);

Параметры

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

Замечания

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

CMFCPropertyGridCtrl::ValidateItemData

Вызывается платформой для проверки данных свойств.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Параметры

pProp
[in] Указатель на свойство. Этот параметр не используется.

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

ВсегдаTRUE.

Замечания

Метод CMFCPropertyGridCtrl::EndEditItem вызывает этот метод для проверки данных. По умолчанию этот метод не использует его pProp параметр, а возвращаемое значение всегда TRUE.

При переопределении этого метода возвращается TRUE , если указанные данные свойства допустимы. В противном случае вернитесь FALSE, в этом случае платформа не обновляет свойство.

См. также

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