Класс IPropertyPageImpl

Этот класс реализует IUnknown и предоставляет реализацию интерфейса IPropertyPage по умолчанию.

Важно!

Этот класс и его члены нельзя использовать в приложениях, выполняемых в среде выполнения Windows.

Синтаксис

template<class T>
class IPropertyPageImpl

Параметры

T
Класс, производный от IPropertyPageImpl.

Участники

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

Имя	Описание
IPropertyPageImpl::IPropertyPageImpl	Конструктор.

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

Имя	Описание
IPropertyPageImpl::Activate	Создает диалоговое окно для страницы свойств.
IPropertyPageImpl::Apply	Применяет текущие значения страницы свойств к базовым объектам, указанным через SetObjects. Реализация ATL возвращает S_OK.
IPropertyPageImpl::D eactivate	Уничтожает окно, созданное с Activateпомощью .
IPropertyPageImpl::GetPageInfo	Извлекает сведения о странице свойств.
IPropertyPageImpl::Help	Вызывает справку Windows для страницы свойств.
IPropertyPageImpl::IsPageDirty	Указывает, изменилась ли страница свойств с момента активации.
IPropertyPageImpl::Move	Положение и изменение размера диалогового окна страницы свойств.
IPropertyPageImpl::SetDirty	Помечает состояние страницы свойства как измененное или без изменений.
IPropertyPageImpl::SetObjects	Предоставляет массив указателей IUnknown для объектов, связанных со страницей свойств. Эти объекты получают текущие значения страницы свойств через вызов Apply.
IPropertyPageImpl::SetPageSite	Предоставляет страницу свойств указателем IPropertyPageSite , с помощью которого страница свойств взаимодействует с кадром свойств.
IPropertyPageImpl::Show	Делает диалоговое окно страницы свойств видимым или невидимым.
IPropertyPageImpl::TranslateAccelerator	Обрабатывает указанный нажатие клавиши.

Открытые члены данных

Имя	Описание
IPropertyPageImpl::m_bDirty	Указывает, изменилось ли состояние страницы свойства.
IPropertyPageImpl::m_dwDocString	Сохраняет идентификатор ресурса, связанный с текстовой строкой, описывающей страницу свойства.
IPropertyPageImpl::m_dwHelpContext	Сохраняет идентификатор контекста для раздела справки, связанного со страницей свойств.
IPropertyPageImpl::m_dwHelpFile	Сохраняет идентификатор ресурса, связанный с именем файла справки, описывающего страницу свойства.
IPropertyPageImpl::m_dwTitle	Сохраняет идентификатор ресурса, связанный с текстовой строкой, которая отображается на вкладке страницы свойств.
IPropertyPageImpl::m_nObjects	Сохраняет количество объектов, связанных со страницей свойств.
IPropertyPageImpl::m_pPageSite	Указывает на IPropertyPageSite интерфейс, через который страница свойств взаимодействует с кадром свойств.
IPropertyPageImpl::m_ppUnk	Указывает на массив указателей IUnknown на объекты, связанные со страницей свойств.
IPropertyPageImpl::m_size	Сохраняет высоту и ширину диалогового окна страницы свойств в пикселях.

Замечания

Интерфейс IPropertyPage позволяет объекту управлять определенной страницей свойств в листе свойств. Класс IPropertyPageImpl предоставляет реализацию этого интерфейса по умолчанию и реализует IUnknown путем отправки сведений на устройство дампа в отладочных сборках.

Руководство по созданию проекта ATL в статьяхATL

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

IPropertyPage

IPropertyPageImpl

Требования

Header: atlctl.h

IPropertyPageImpl::Activate

Создает диалоговое окно для страницы свойств.

HRESULT Activate(
    HWND hWndParent,
    LPCRECT pRect,
    BOOL bModal);

Замечания

По умолчанию диалоговое окно всегда без режима независимо от значения параметра bModal .

См. раздел IPropertyPage::Activate в пакете SDK для Windows.

IPropertyPageImpl::Apply

Применяет текущие значения страницы свойств к базовым объектам, указанным через SetObjects.

HRESULT Apply();

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

Возвращает S_OK.

Замечания

См. раздел IPropertyPage::Apply в пакете SDK для Windows.

IPropertyPageImpl::D eactivate

Удаляет диалоговое окно, созданное с помощью активации.

HRESULT Deactivate();

Замечания

См. раздел IPropertyPage::D eactivate в пакете SDK для Windows.

IPropertyPageImpl::GetPageInfo

Заполняет структуру pPageInfo сведениями, содержащимися в элементах данных.

HRESULT GetPageInfo(PROPPAGEINFO* pPageInfo);

Замечания

GetPageInfo загружает строковые ресурсы, связанные с m_dwDocString, m_dwHelpFile и m_dwTitle.

См. раздел IPropertyPage::GetPageInfo в пакете SDK для Windows.

IPropertyPageImpl::Help

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

HRESULT Help(PROPPAGEINFO* pPageInfo);

Замечания

См. раздел IPropertyPage::Help в пакете SDK для Windows.

IPropertyPageImpl::IPropertyPageImpl

Конструктор.

IPropertyPageImpl();

Замечания

Инициализирует все элементы данных.

IPropertyPageImpl::IsPageDirty

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

HRESULT IsPageDirty(void);

Замечания

IsPageDirty возвращает S_OK, если страница изменилась с момента активации.

IPropertyPageImpl::m_bDirty

Указывает, изменилось ли состояние страницы свойства.

BOOL m_bDirty;

IPropertyPageImpl::m_nObjects

Сохраняет количество объектов, связанных со страницей свойств.

ULONG m_nObjects;

IPropertyPageImpl::m_dwHelpContext

Сохраняет идентификатор контекста для раздела справки, связанного со страницей свойств.

DWORD m_dwHelpContext;

IPropertyPageImpl::m_dwDocString

Сохраняет идентификатор ресурса, связанный с текстовой строкой, описывающей страницу свойства.

UINT m_dwDocString;

IPropertyPageImpl::m_dwHelpFile

Сохраняет идентификатор ресурса, связанный с именем файла справки, описывающего страницу свойства.

UINT m_dwHelpFile;

IPropertyPageImpl::m_dwTitle

Сохраняет идентификатор ресурса, связанный с текстовой строкой, которая отображается на вкладке страницы свойств.

UINT m_dwTitle;

IPropertyPageImpl::m_pPageSite

Указывает на интерфейс IPropertyPageSite , через который страница свойств взаимодействует с кадром свойств.

IPropertyPageSite* m_pPageSite;

IPropertyPageImpl::m_ppUnk

Указывает на массив указателей IUnknown на объекты, связанные со страницей свойств.

IUnknown** m_ppUnk;

IPropertyPageImpl::m_size

Сохраняет высоту и ширину диалогового окна страницы свойств в пикселях.

SIZE m_size;

IPropertyPageImpl::Move

Положение и изменение размера диалогового окна страницы свойств.

HRESULT Move(LPCRECT pRect);

Замечания

См. раздел IPropertyPage::Move в пакете SDK для Windows.

IPropertyPageImpl::SetDirty

Помечает состояние страницы свойства как измененное или без изменений в зависимости от значения bDirty.

void SetDirty(BOOL bDirty);

Параметры

bDirty
[in] Если значение TRUE, состояние страницы свойства помечается как измененное. В противном случае оно помечается как неизменное.

Замечания

При необходимости сообщает кадру, SetDirty что страница свойства изменилась.

IPropertyPageImpl::SetObjects

Предоставляет массив указателей IUnknown для объектов, связанных со страницей свойств.

HRESULT SetObjects(ULONG nObjects, IUnknown** ppUnk);

Замечания

См. раздел IPropertyPage::SetObjects в пакете SDK для Windows.

IPropertyPageImpl::SetPageSite

Предоставляет страницу свойств с указателем IPropertyPageSite , с помощью которого страница свойств взаимодействует с кадром свойств.

HRESULT SetPageSite(IPropertyPageSite* pPageSite);

Замечания

См. раздел IPropertyPage::SetPageSite в пакете SDK для Windows.

IPropertyPageImpl::Show

Делает диалоговое окно страницы свойств видимым или невидимым.

HRESULT Show(UINT nCmdShow);

Замечания

См. раздел IPropertyPage::Show в пакете SDK для Windows.

IPropertyPageImpl::TranslateAccelerator

Обрабатывает нажатие клавиш, указанное в pMsg.

HRESULT TranslateAccelerator(MSG* pMsg);

Замечания

См. раздел IPropertyPage::TranslateAccelerator в пакете SDK для Windows.

См. также

Класс IPropertyPage2Impl
Класс IPerPropertyBrowsingImpl
Класс ISpecifyPropertyPagesImpl
Общие сведения о классе