IPropertyPage-Schnittstelle (ocidl.h)

Artikel
08/25/2023

Stellt die Standard Features eines Eigenschaftenseitenobjekts bereit, das eine bestimmte Seite innerhalb eines Eigenschaftenblatts verwaltet. Eine Eigenschaftenseite implementiert mindestens IPropertyPage und kann optional IPropertyPage2 implementieren, wenn die Auswahl einer bestimmten Eigenschaft unterstützt wird. Weitere Informationen zum Durchsuchen bestimmter Eigenschaften finden Sie unter IPerPropertyBrowsing::MapPropertyToPage . Die Methoden von IPropertyPage2 ermöglichen es dem Eigenschaftenblatt oder dem Eigenschaftenrahmen, die Seite anzuweisen, wann bestimmte Aktionen ausgeführt werden sollen, die hauptsächlich auf Benutzereingaben basieren, z. B. das Wechseln zwischen Seiten oder das Drücken verschiedener Schaltflächen, die der Frame selbst im Dialogfeld verwaltet.

Eine Eigenschaftenseite verwaltet ein Dialogfeld, das nur die Steuerelemente enthält, die für diese eine Seite im Eigenschaftenblatt selbst angezeigt werden sollen. Dies bedeutet, dass die Dialogfeldvorlage, die zum Definieren der Seite verwendet wird, nur die WS_CHILD Formatvorlage und keine anderen enthalten darf. Es sollte keine Stile enthalten, die sich auf einen Frame, Untertitel oder Systemmenüs oder Steuerelemente beziehen.

Vererbung

Die IPropertyPage-Schnittstelle erbt von der IUnknown-Schnittstelle . IPropertyPage verfügt auch über folgende Arten von Membern:

Methoden

Die IPropertyPage-Schnittstelle verfügt über diese Methoden.


IPropertyPage::Activate Erstellt das Dialogfeldfenster für die Eigenschaftenseite.
IPropertyPage::Apply Wendet die aktuellen Werte auf die zugrunde liegenden Objekte an, die der Eigenschaftenseite zugeordnet sind, wie sie zuvor an IPropertyPage::SetObjects übergeben wurden.
IPropertyPage::D eactivate Zerstört das in IPropertyPage::Activate erstellte Fenster.
IPropertyPage::GetPageInfo Ruft Informationen zur Eigenschaftenseite ab.
IPropertyPage::Help Ruft die Eigenschaftenseite als Antwort auf eine Endbenutzeranforderung auf.
IPropertyPage::IsPageDirty Gibt an, ob sich die Eigenschaftenseite seit der Aktivierung oder seit dem letzten Aufruf von Apply geändert hat.
IPropertyPage::Move Positioniert und ändert die Größe des Dialogfelds Eigenschaftenseite innerhalb des Rahmens.
IPropertyPage::SetObjects Stellt die Eigenschaftenseite mit einem Array von Zeigern auf Objekte bereit, die dieser Eigenschaftenseite zugeordnet sind.
IPropertyPage::SetPageSite Initialisiert eine Eigenschaftenseite und stellt die Seite mit einem Zeiger auf die IPropertyPageSite-Schnittstelle bereit, über die die Eigenschaftenseite mit dem Eigenschaftenrahmen kommuniziert.
IPropertyPage::Show Macht das Dialogfeld Eigenschaftenseite sichtbar oder unsichtbar. Wenn die Seite sichtbar gemacht wird, sollte die Seite den Fokus auf sich selbst festlegen, insbesondere auf die erste Eigenschaft auf der Seite.
IPropertyPage::TranslateAccelerator Übergibt zur Verarbeitung eine Tastenkombination an die Eigenschaftenseite.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

OleCreatePropertyFrame

OleCreatePropertyFrameIndirect