CPropertySheet-Klasse

Artikel
02/26/2013

Stellt Eigenschaftenblätter, auch als Dialogfelder im Registerformat dar.

class CPropertySheet : public CWnd

Mitglieder

Öffentliche Konstruktoren

Name	Description
CPropertySheet::CPropertySheet	Erstellt ein CPropertySheet-Objekt.

Öffentliche Methoden

Name	Description
CPropertySheet::AddPage	Fügt eine Seite dem Eigenschaftenblatt hinzu.
CPropertySheet::Construct	Erstellt ein CPropertySheet-Objekt.
CPropertySheet::Create	Zeigt ein nicht modales Eigenschaftenblatt an.
CPropertySheet::DoModal	Zeigt ein modales Eigenschaftenblatt an.
CPropertySheet::EnableStackedTabs	Gibt die ob gestapelte Eigenschaftenblattverwendung oder Bildlaufregisterkarten an.
CPropertySheet::EndDialog	Beendet das Eigenschaftenblatt.
CPropertySheet::GetActiveIndex	Ruft den Index der aktuellen Seite des Eigenschaftenblatts ab.
CPropertySheet::GetActivePage	Gibt das Objekt der aktiven Seite zurück.
CPropertySheet::GetPage	Ruft einen Zeiger auf die angegebene Seite ab.
CPropertySheet::GetPageCount	Ruft die Anzahl vonseiten im Eigenschaftenblatt ab.
CPropertySheet::GetPageIndex	Ruft den Index der angegebenen Seite des Eigenschaftenblatts ab.
CPropertySheet::GetTabControl	Ruft einen Zeiger auf ein Tab-Steuerelement ab.
CPropertySheet::MapDialogRect	Konvertiert die Dialogeinheiten eines Rechtecks, um Einheiten zu stößt.
CPropertySheet::OnInitDialog	Überschreiben Sie, um von Eigenschaftenblattinitialisierung zu erweitern.
CPropertySheet::PressButton	Simuliert die Auswahl der angegebenen Schaltfläche in einem Eigenschaftenblatt.
CPropertySheet::RemovePage	Entfernt eine Seite aus dem Eigenschaftenblatt.
CPropertySheet::SetActivePage	Legt das Objekt programmgesteuert der aktiven Seite fest.
CPropertySheet::SetFinishText	Legt den Text für die Endschaltfläche fest.
CPropertySheet::SetTitle	Legt die Beschriftung des Eigenschaftenblatts fest.
CPropertySheet::SetWizardButtons	Aktiviert die Assistentenschaltflächen.
CPropertySheet::SetWizardMode	Aktiviert den Assistentenmodus.

Öffentliche Datenmember

Name	Description
CPropertySheet::m_psh	Die Struktur Windows PROPSHEETHEADER.Bietet Zugriff auf den grundlegenden Eigenschaftenblattparametern.

Hinweise

Ein CPropertySheet-Eigenschaftenblatt besteht aus einem Objekt und mindestens einem CPropertyPage-Objekten.Das Framework wird ein Eigenschaftenblatt als Fenster mit einem Satz von Registerkartenindizes und Bereich an, der die gerade ausgewählte Seite enthält.Der Benutzer navigiert zu einer bestimmten Seite, indem er die entsprechende Registerkarte verwendet.

CPropertySheet bietet Unterstützung für die erweiterte PROPSHEETHEADER-Struktur, die in Windows 98 und in Windows NT 2000 eingeführt wurde.Die Struktur enthält zusätzliche Flags und Member, die mit einer "Wasserzeichen" Hintergrundbitmaps unterstützen.

Um diese neuen Bilder in Ihrem Eigenschaftenblattobjekt automatisch anzuzeigen, übergeben Sie für die Bitmap- und Palettenimages im Aufruf von CPropertySheet::Construct oder zu CPropertySheet::CPropertySheet.

Obwohl CPropertySheet nicht von CDialog-Klasse abgeleitet ist, ein Objekt zu verwalten CPropertySheet ist wie das Verwalten eines CDialog-Objekts.Beispielsweise erfordert Erstellung eines Eigenschaftenblatts zweiteilige Konstruktion: Rufen Sie den Konstruktor, und rufen Sie dann DoModal für ein modales Eigenschaftenblatt oder Erstellen Sie für ein nicht modales Eigenschaftenblatt auf.CPropertySheet-Typen verfügt über zwei Konstruktoren: CPropertySheet::Construct und CPropertySheet::CPropertySheet.

Wenn Sie ein Objekt erstellen, CPropertySheet kann entweder Fensterstile Chance bewirken eine Ausnahme auftritt.Dies ergibt sich vom System, die versucht, das Format des Eigenschaftenblatts zu ändern, bevor das Blatt erstellt wird.Um diese Ausnahme zu vermeiden, dass Sie festgelegt den folgenden Formaten wenn Sie das CPropertySheet erstellen:

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

Die folgenden Formate sind optional und werden nicht die Chance Ausnahme verursachen:

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN

Jedes andere Window Styles sind unzulässig und Sie sollten sie nicht aktivieren.

Austauschdaten CPropertySheet zwischen einem Objekt und einem externen Objekt sind an die Austauschdaten mit einem CDialog-Objekt.Der wichtige Unterschied ist, dass die Einstellungen eines Eigenschaftenblatts in der Regel Membervariablen der CPropertyPage-Objekte und nicht als CPropertySheet des Objekts selbst sind.

Sie können einen Typ Dialogfeld im Registerformat erstellen aufgerufen einen Assistenten, der aus einem Eigenschaftenblatt mit einer Sequenz von Eigenschaftenseiten besteht, die den Benutzer durch die Schritte eines Vorgangs, wie Installieren eines Geräts oder Erstellen eines Newsletters übergeben.In einem assistentenartigdialogfeld im registerformat haben die Eigenschaftenseiten nicht Registerkarten, und nur eine Eigenschaftenseite ist gleichzeitig sichtbar.Außerdem, anstatt OK und Jetzt übernehmen Schaltflächen zu haben, hat ein assistentenartigdialogfeld im registerformat eine Schaltfläche Zurück, eine Weiter oder Schaltfläche Fertig stellen, Abbrechen eine Schaltfläche und eine Schaltfläche Hilfe.

Um ein assistentenartigdialogfeld zu erstellen, führen Sie die gleichen Schritte zum Upgrade würden um ein Standardeigenschaftenblatt zu erstellen, aber bevor Sie Aufruf SetWizardMode DoModal aufrufen.Um die Assistentenschaltflächen zu aktivieren, rufen Sie SetWizardButtons, mit den Flags auf ihre Funktion und Darstellung anzupassen.Um die Schaltfläche Fertig stellen, hat Aufruf SetFinishText nach dem Benutzer zu ermöglichen Aktionen auf der letzten Seite des Assistenten ausgeführt.

Weitere Informationen dazu, wie CPropertySheet-Objekte, finden Sie im Artikel Eigenschaftenblätter und Eigenschaftenseiten verwendet.Außerdem finden Sie im Knowledge Base-Artikel Q146916: HOWTO: Erstellen Sie ein nicht modales CPropertySheet mit Standardschaltflächen und Artikel Q300606: HOWTO: Entwerfen Sie ein in der Größe veränderbares MFC-Eigenschaftenblatt.