Класс CMFCPropertyGridCtrl
Этот раздел включен для обеспечения полноты. Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc каталога установки Visual Studio.
Поддерживает редактируемые элемент управления сетки свойств, можно отобразить свойства в алфавитном или иерархическом порядке.
class CMFCPropertyGridCtrl : public CWnd
Члены
Открытые конструкторы
Имя |
Описание |
|---|---|
Создает объект CMFCPropertyGridCtrl. |
|
CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl |
Деструктор. |
Открытые методы
Имя |
Описание |
|---|---|
CMFCPropertyGridCtrl::accHitTest |
Вызываемый платформой для получения дочернего элемента или дочерний объект в заданной точке на экране. (Переопределяет CWnd::accHitTest). |
CMFCPropertyGridCtrl::accLocation |
Вызываемый платформой для получения расположения экрана указанного объекта и текущий. (Переопределяет CWnd::accLocation). |
Вызываемый платформой, чтобы изменить выделение или переместить фокус клавиатуры для указанного объекта. (Переопределяет CWnd::accSelect). |
|
Добавляет новое свойство в элемент управления сетки свойств. |
|
|
|
Закрывает диалоговое окно выбора цвета. |
|
Создает элемент управления сетки свойств и вложение его к объекту управления сетки свойств. |
|
Удаляет указанное свойство элемента управления сетки свойств. |
|
|
|
Включение или отключение область описания, которая отображается под списком свойств. |
|
Включение или отключение элемент управления заголовка в верхней части элемента управления сетки свойств. |
|
Прокручивает элемент управления сетки свойств и развернуть элементы свойства до тех пор, пока указанное свойство не будет видимо. |
|
Развернуть или свернуть все узлы элемента управления сетки свойств. |
|
Извлекает свойство, сопоставлено с определяемыми пользователем значение DWORD. |
|
CMFCPropertyGridCtrl::get_accChild |
Вызываемый платформой для получения адреса интерфейса IDispatch для заданного дочернего элемента. (Переопределяет CWnd::get_accChild). |
Вызываемый платформой для получения число дочерних объектов, принадлежащих этому объекту. (Переопределяет CWnd::get_accChildCount). |
|
CMFCPropertyGridCtrl::get_accDefaultAction |
Вызываемый платформой для получения строку, описывающую выполняемое по умолчанию объекта. (Переопределяет CWnd::get_accDefaultAction). |
CMFCPropertyGridCtrl::get_accDescription |
Вызываемый платформой для получения строку, описывающую внешний вид указанного объекта. (Переопределяет CWnd::get_accDescription). |
Вызываемый платформой для получения объект, имеющий фокус клавиатуры. (Переопределяет CWnd::get_accFocus). |
|
Вызываемый платформой для получения строки свойства Help объекта. (Переопределяет CWnd::get_accHelp). |
|
Вызывается платформой, чтобы получить полный путь к файлу WinHelp, связанного с указанным объектом и идентификатором соответствующей разделы в этот файл. (Переопределяет CWnd::get_accHelpTopic). |
|
Вызываемый платформой для получения сочетание клавиш или клавиша доступа для указанного объекта. (Переопределяет CWnd::get_accKeyboardShortcut). |
|
CMFCPropertyGridCtrl::get_accName |
Вызываемый платформой для получения имя указанного объекта. (Переопределяет CWnd::get_accName). |
CMFCPropertyGridCtrl::get_accRole |
Вызываемый платформой для получения сведения, которые описывают роль указанного объекта. (Переопределяет CWnd::get_accRole). |
Вызываемый платформой для получения выбранные дочерние элементы данного объект. (Переопределяет CWnd::get_accSelection). |
|
CMFCPropertyGridCtrl::get_accState |
Вызываемый платформой для получения текущее состояние заданного объекта. (Переопределяет CWnd::get_accState). |
CMFCPropertyGridCtrl::get_accValue |
Вызываемый платформой для получения значения указанного объекта. (Переопределяет CWnd::get_accValue). |
Возвращает цвет фона текущего элемента управления сетки свойств. |
|
Получает шрифт Windows, текст в текущем элементе управления сетки свойств полужирным стиле. |
|
Получает текущее выбранное свойство. |
|
Получает цвет, в настоящее время определенных для элементов управления сетки свойств. |
|
Получает высоту области описаний, расположенной в нижней части элемента управления сетки свойств. |
|
Извлекает число строк в области описание текущего управления сетки свойств. |
|
Извлекает внутренний объект CMFCHeaderCtrl, инфраструктура использует для отображения текущего управления сетки свойств. |
|
Получает высоту заголовка элемента управления сетки свойств. |
|
Возвращает ширину левого столбца текущего управления сетки свойств, содержащее имя каждого свойства. |
|
Получает ограничивающий прямоугольник управления сетки свойств. |
|
Извлекает указатель на объект свойства, соответствующее указанному индексу элемента управления сетки свойств. |
|
Извлекает текущую ширину столбца, содержащего значения свойства. |
|
Возвращает количество свойств в элементе управления сетки свойств. |
|
Получает высоту строки в элементе управления сетки свойств. |
|
Извлекает указатель к элементу управления полосы прокрутки в элементе управления сетки свойств. (Переопределяет CWnd::GetScrollBarCtrl). |
|
Получает цвет текста элементов свойства в текущем элементе управления сетки свойств. |
|
CMFCPropertyGridCtrl::GetThisClass |
Используемый платформой для получения указателя на объект CRuntimeClass, который связан с этим типом класса. |
Извлекает указатель на объект свойства, соответствующий элементу управления сетки свойств, если указанная точка находится на элементе. Этот метод также указывает область в элементе управления сетки свойств, содержащий точку. |
|
Инициализирует внутренний объект CMFCHeaderCtrl, инфраструктура использует для отображения текущего управления сетки свойств. |
|
Указывает, является ли элемент управления сетки свойств в алфавитном режиме. |
|
|
|
Указывает, отображается ли область описания управления сетки свойств. |
|
Указывает, отображается ли каждое имя группы свойств с помощью ширину текущего управления сетки свойств. |
|
Указывает, отображается ли элемент управления заголовка. |
|
Показывает, как элемент управления сетки свойств показывает измененные свойства. |
|
Указывает, что границы перерисовывает столбцы name и значения текущего управления сетки свойств, когда пользователь изменяет размер столбцов. |
|
Указывает, является ли внешний вид элемента управления сетки свойств в стиле, который используется by С .NET. |
|
Определяет способ отображения измененных свойств. |
|
CMFCPropertyGridCtrl::PreTranslateMessage |
Используемый классом CWinApp для трансляции сообщения окна, прежде чем они будут передается функции TranslateMessage и DispatchMessage Windows. (Переопределяет CWnd::PreTranslateMessage). |
Удаляет все объекты свойства из элемента управления сетки свойств. |
|
Получает исходное значения всех свойств. |
|
Задает или режим возвратов алфавитный. |
|
Указывает текст логических меток. |
|
Выберите свойство в элементе управления сетки свойств. |
|
Указывает цвет для различных элементов управления сетки свойств. |
|
Указывает количество строк для отображения в разделе описания текущего управления сетки свойств. |
|
Указывает, нужно ли отображать полную ширину имя категории для группы свойств в составе в текущем элементе управления сетки свойств. |
|
Указывает символ, который будет использоваться в качестве разделителя в списке значений свойств. |
|
Определяет границы перерисовывает ли столбцы name и значения текущего управления сетки свойств, когда пользователь изменяет размер столбцов. |
|
Задает внешний вид элемента управления сетки свойств к стилю, используемый в VS .NET. |
|
Устанавливает значение цвета выделенного свойства цвета. |
Защищенные методы
Имя |
Описание |
|---|---|
Перерисовывает элемент управления сетки свойств и его свойства. |
|
Называемый элементом управления сетки свойств для сортировки свойств. |
|
Вызывается инфраструктурой при запуске пользователя для изменения свойства. |
|
Вызываемый платформой, когда пользователь останавливает изменить свойство. |
|
Вызываемый платформой для инициализации элемента управления сетки свойств. |
|
Вызываемый платформой, если текущее выделение будет изменен. |
|
Вызываемый платформой, если кнопка свойства будет нажата. |
|
Вызываемый платформой для рисования границы вокруг элемента управления сетки свойств. |
|
Вызываемый платформой для рисования область описания и отображать текст описания. |
|
Вызываемый платформой для отображения списка свойств в элементе управления сетки свойств. |
|
Вызываемый платформой для отображения свойства. |
|
Вызываемый платформой, когда будет изменен значение свойства. |
|
Вызываемый платформой, когда свойство, которое содержит элемент управления " поле со списком выделен. |
|
Вызываемый платформой для проверки данных свойства. |
Заметки
Класс CMFCPropertyGridCtrl элемент управления сетки свойств, которое содержит редактируемый свойства, производные от класса CMFCPropertyGridProperty. Каждое свойство может представлять тип и оно может содержать подэлементов. Элемент управления сетки свойств поддерживает resizable область внизу, может отображать описание выбранного свойства.
Для использования элемента управления сетки свойств, создайте объект CMFCPropertyGridCtrl и затем вызовите метод CMFCPropertyGridCtrl::Create. Используйте метод CMFCPropertyGridCtrl::AddProperty для добавления свойства в список.
Свойства выделения
Вместо представления значение элемента свойства может запустить диалоговое окно, которое позволяет пользователю выбирать цвета, файл или шрифт.
В следующей таблице перечислены 4 типа свойства выделения.
Класс |
Описание |
|---|---|
Свойство общего назначения, используемое для определения строк, даты, Логические значения и т д |
|
Свойство, которое используется для выбора значение цвета. |
|
Свойство, которое используется для выбора файла. |
|
Свойство, которое используется для выбора шрифта. |
Рисунки
На следующих рисунках элемент управления сетки свойств отображаются свойства в 2 способами. На первой иллюстрации показана свойства иерархически, а второе свойства отображаются в алфавитном порядке.
.png "Список свойств “PropertySheet”")
Пример
В следующем примере показано, как настроить объект управления сетки свойств с помощью различных методов в классе 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();
Иерархия наследования
Требования
заголовок: afxpropertygridctrl.h