Freigeben über


Verwenden der Eigenschaftenblätter in der Anwendung

Um ein Eigenschaftenblatt in der Anwendung zu verwenden, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine Dialogfeldvorlagen-Ressource für jede Eigenschaftenseite.Beachten Sie, dass der Benutzer von einer Seite zur anderen wechseln, sodass pro Seite festlegen möglichst konsistent.

    Die Dialogfeldvorlagen für alle Seiten müssen nicht die gleiche Größe aufweisen.Das Framework verwendet die Größe des größten Seite, um zu ermitteln, wie groß die Eigenschaftenseiten für Eigenschaftenblatt im Bereich zuzuordnen.

    Wenn Sie die Dialogfeldvorlagen-Ressource für eine Eigenschaftenseite erstellen, müssen Sie die folgenden Formate im Dialogfeld-Eigenschaft eigenschaftenblatt angeben:

    • Legen Sie das Beschriftung Eingabefeld auf der Allgemein Seite auf Text fest, den Sie auf der Registerkarte für diese Seite angezeigt werden sollen.

    • Legen Sie das Formatvorlage Listenfeld auf der Seite ChildStile fest.

    • Legen Sie das Randbereich Listenfeld auf der Seite DünnStile fest.

    • Stellen Sie sicher, dass das Kontrollkästchen auf der Seite Stile Titlebar ausgewählt ist.

    • Stellen Sie sicher, dass das Kontrollkästchen auf der Seite Weitere FormateDeaktiviert ausgewählt ist.

  2. Erstellen Sie CPropertyPage abgeleitete Klasse entsprechend jeder dialogfeldvorlage Eigenschaftenseiten.Weitere Informationen finden Sie unter Eine Klasse hinzufügen.Wählen Sie CPropertyPage als Basisklasse aus.

  3. Erstellen Sie die Membervariablen, um die Werte für diese Eigenschaftenseite enthält.Der Prozess zum Hinzufügen von Membervariablen in einer Eigenschaftenseite entspricht genau dem, Membervariablen in einem Dialogfeld eine Eigenschaftenseite hinzufügen, da ein spezialisiertes Dialogfeld ist.Weitere Informationen finden Sie unter Membervariablen für Dialogfeld-Kontrollen definieren.

  4. Erstellen Sie ein CPropertySheet-Objekt im Quellcode.Normalerweise erstellen Sie das CPropertySheet-Objekt im Handler für den Befehl, der das Eigenschaftenblatt angezeigt wird.Dieses Objekt stellt das gesamte Eigenschaftenblatt dar.Wenn Sie ein modales Eigenschaftenblatt mit der DoModal-Funktion erstellen, gibt das Framework drei Befehlsschaltflächen standardmäßig angezeigt: OK, Abbrechen und gelten.Das Framework stellt keine Befehlsschaltflächen für die nicht modalen Eigenschaftenblätter, die mit der Erstellen-Funktion erstellt wurden.Sie müssen eine Klasse von CPropertySheet zu berechnen, es sei denn, Sie entweder auf andere Steuerelemente hinzufügen (z. B. ein Vorschaufenster anzeigen) oder ein nicht modales Eigenschaftenblatt soll.Dieser Schritt ist für nicht modalen Eigenschaftenblätter erforderlich, da sie keine Standardsteuerelemente enthält, die verwendet werden können, um das Eigenschaftenblatt zu schließen.

  5. Für jede Seite zum Eigenschaftenblatt hinzugefügt werden kann, gehen Sie wie folgt vor:

    • Erstellen Sie ein Objekt für jedes CPropertyPage abgeleiteten Klasse, dass Sie bereits in diesem Prozess erstellt haben.

    • CPropertySheet::AddPage Aufruf für jede Seite.

    Normalerweise erstellt das Objekt, das CPropertySheetCPropertyPage-Objekte ebenfalls erstellt, die in diesem Schritt.Wenn Sie jedoch CPropertySheet abgeleitete Klasse, die CPropertyPage-Objekte im CPropertySheet-Objekt einbetten und AddPage für jede Seite aufrufen können CPropertySheet- Konstruktor der abgeleiteten Klasse implementieren.AddPageCPropertyPage-Objekt, das Hinzufügen der Liste des Eigenschaftenblatts vonseiten aber nicht wirklich stellt das Fenster für diese Seite.Daher ist es nicht notwendig, bis der Erstellung des Fensters Eigenschaftenblatt zu warten, dass AddPage aufzurufen. Sie können AddPage vom Konstruktor des Eigenschaftenblatts aufrufen.

    Wenn ein Eigenschaftenblatt mehr Registerkarten hat, als in einer einzelnen Zeile des Eigenschaftenblatts passt, werden die Registerkarten Stapel in mehreren Zeilen.Weitere Informationen zum Stapeln deaktivieren, rufen Sie CPropertySheet::EnableStackedTabs mit dem Parameter festgelegt FALSE.Sie müssen EnableStackedTabs aufrufen, wenn Sie das Eigenschaftenblatt erstellen.

  6. Rufen Sie CPropertySheet::DoModal oder Erstellen auf, um das Eigenschaftenblatt anzuzeigen.Rufen Sie DoModal auf, um ein Eigenschaftenblatt als modales Dialogfeld.Rufen Sie Create auf, um das Eigenschaftenblatt als nicht modales Dialogfeld.

  7. Exchange-Daten zwischen Eigenschaftenseiten und dem Besitzer des Eigenschaftenblatts.Dies wird im Artikel Austausch-Daten erläutert.

Ein Beispiel dafür, wie Eigenschaftenblätter, finden Sie das allgemeine Beispiel PROPDLG MFC verwendet.

Siehe auch

Konzepte

Eigenschaftenblätter (MFC)