Интерфейс IPropertyPage (ocidl.h)

Статья
08/25/2023

Предоставляет main функции объекта страницы свойств, который управляет определенной страницей на странице свойств. Страница свойств реализует по крайней мере IPropertyPage и может при необходимости реализовать IPropertyPage2 , если поддерживается выбор определенного свойства. Дополнительные сведения о просмотре определенных свойств см. в разделе IPerPropertyBrowsing::MapPropertyToPage . Методы IPropertyPage2 позволяют листу свойств или фрейму свойств указать странице, когда следует выполнять определенные действия, в основном на основе пользовательских данных, таких как переключение между страницами или нажатие различных кнопок, которыми сам фрейм управляет в диалоговом окне.

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

Наследование

Интерфейс IPropertyPage наследуется от интерфейса IUnknown . IPropertyPage также имеет следующие типы элементов:

Методы

Интерфейс IPropertyPage содержит следующие методы.


IPropertyPage::Activate Создает диалоговое окно для страницы свойств.
IPropertyPage::Apply Применяет текущие значения к базовым объектам, связанным со страницей свойств, которые ранее были переданы в IPropertyPage::SetObjects.
IPropertyPage::D eactivate Удаляет окно, созданное в IPropertyPage::Activate.
IPropertyPage::GetPageInfo Извлекает сведения о странице свойств.
IPropertyPage::Help Вызывает справку страницы свойств в ответ на запрос конечного пользователя.
IPropertyPage::IsPageDirty Указывает, изменилась ли страница свойств с момента ее активации или с момента последнего вызова метода Apply.
IPropertyPage::Move Размещает и изменяет размер диалогового окна страницы свойств в кадре.
IPropertyPage::SetObjects Предоставляет странице свойств массив указателей на объекты, связанные с этой страницей свойств.
IPropertyPage::SetPageSite Инициализирует страницу свойств и предоставляет странице указатель на интерфейс IPropertyPageSite, через который страница свойств взаимодействует с кадром свойства.
IPropertyPage::Show Делает диалоговое окно страницы свойств видимым или невидимым. Если страница становится видимой, она должна установить фокус на себя, в частности на первое свойство на странице.
IPropertyPage::TranslateAccelerator Передает нажатие клавиши на страницу свойств для обработки.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ocidl.h

См. также раздел

OleCreatePropertyFrame

OleCreatePropertyFrameIndirect

Share via