Implementing Property Pages
Eigenschaftenseiten sind COM-Objekte, die IPropertyPage oder die IPropertyPage2-Schnittstelle implementieren. ATL bietet Unterstützung für das Implementieren von Eigenschaftenseiten von ATL-Eigenschaftenseiten-Assistent in Fügen Sie Klassendialogfeld hinzu.
So fügen Sie eine Eigenschaftenseite mit ATL erstellen:
Erstellen oder öffnen Sie ein Serverprojekt ATL-DynamicLink Library (DLL).
Öffnen Sie Fügen Sie Klassendialogfeld hinzu und wählen Sie ATL-Eigenschaftenseite aus.
Stellen Sie sicher, dass die Eigenschaftenseite das verlegte Apartment befindet (da sie eine Benutzeroberfläche besitzt).
Legen Sie den Namen, die Beschreibung (Doc. Zeichenfolgen-) und die der Seite zugeordnet werden Hilfedatei, fest.
Fügen Sie Steuerelemente der generierten Dialogfeldressource hinzu, die als Benutzeroberfläche der Eigenschaftenseite fungiert.
Reagieren auf Änderungen in der Benutzeroberfläche der Seite, um die Validierung auszuführen, die Seitensite zu aktualisieren, oder die Objekte zu aktualisieren, die der Seite zugeordnet werden. Insbesondere Aufruf IPropertyPageImpl::SetDirty, wenn ein Benutzer Änderungen an der Eigenschaftenseite vornimmt.
Überschreiben Sie optional die IPropertyPageImpl-Methoden mithilfe der Richtlinien unten.
IPropertyPageImpl-Methode
Überschreiben Sie, wenn Sie möchten...
Hinweise
Ausführen grundlegender Plausibilitätsprüfungen auf der Anzahl von Objekten aus, die der Seite und auf Schnittstellen, die sie unterstützen, übergeben werden.
Ausführen von eigenem Code, bevor Sie die Basisklassenimplementierung aufrufen. Wenn die Objekte, die festgelegt werden, nicht an Ihren Erwartungen anpassen, sollten Sie den Aufruf so schnell wie möglich beibehalten.
Initialisieren Sie die Benutzeroberfläche der Seite (beispielsweise, legen Sie Dialogfeld-Steuerelemente mit aktuellen Eigenschaftswerten von Objekten fest, erstellen Sie Steuerelemente dynamisch oder führen Sie andere Initialisierungen aus).
Rufen Sie die Basisklassenimplementierung vor dem Code auf, sodass die Basisklasse eine Möglichkeit haben, das Dialogfeld zu erstellen und alle Steuerelemente, bevor Sie versuchen, diese zu aktualisieren.
Überprüfen Sie die Eigenschafteneinstellungen und aktualisieren Sie die Objekte.
Es ist nicht erforderlich, die Basisklassenimplementierung aufzurufen, da sie keine abgesehen von der Ablaufverfolgung Aufruf geschieht.
Löschen Sie fensterbezogene Elemente auf.
Die Basisklassenimplementierung zerstört das Dialogfeld, das die Eigenschaftenseite darstellt. Wenn Sie bereinigen müssen, bevor das Dialogfeld zerstört wird, sollten Sie den Code hinzufügen, bevor Sie die Basisklasse aufrufen.
Ein Beispiel finden Eigenschaftenseitenimplementierung, Beispiel: Implementieren einer Eigenschaftenseite.
Hinweis
Wenn Sie ActiveX-Steuerelemente in der Eigenschaftenseite hosten möchten, müssen Sie die Ableitung der vom Assistenten generierte Klasse ändern.Ersetzen Sie CDialogImpl<CYourClass> durch CAxDialogImpl<CYourClass> in der Liste der Basisklassen.