PROPSHEETHEADER-Struktur

Definiert den Rahmen und die Seiten eines Eigenschaftenblatts.

Syntax

typedef struct {
    DWORD      dwSize;
    DWORD      dwFlags;
    HWND       hwndParent;
    HINSTANCE  hInstance;
    union {
        HICON   hIcon;
        LPCTSTR pszIcon;
    };
    LPCTSTR  pszCaption;
    UINT     nPages;
    union {
        UINT    nStartPage;
        LPCTSTR pStartPage;
    };
    union {
        LPCPROPSHEETPAGE ppsp;
        HPROPSHEETPAGE   *phpage;
    };
    PFNPROPSHEETCALLBACK pfnCallback;
    union {
        HBITMAP hbmWatermark;
        LPCTSTR pszbmWatermark;
    };
    HPALETTE  hplWatermark;
    union {
        HBITMAP hbmHeader;
        LPCSTR  pszbmHeader;
    };
} PROPSHEETHEADER, *LPPROPSHEETHEADER;

Members

dwSize

Typ: DWORD

Größe dieser Struktur in Bytes. Der Eigenschaftenblatt-Manager verwendet diesen Member, um zu bestimmen, welche Version der PROPSHEETHEADER-Struktur Sie verwenden. Weitere Informationen finden Sie in den Hinweisen.

dwFlags

Typ: DWORD

Flags, die angeben, welche Optionen beim Erstellen der Eigenschaftenblattseite verwendet werden. Dieser Member kann eine Kombination der folgenden Werte sein.

Wert Bedeutung
PSH_DEFAULT (0x00000000) Verwendet die Standardbelangen für alle Strukturmember und erstellt ein normales Eigenschaftenblatt. Dieses Flag hat den Wert 0 (null) und wird nicht mit anderen Flags kombiniert.
PSH_AEROWIZARD (0x00004000) Version 6.00 und höher. Erstellt ein Eigenschaftenblatt des Assistenten, das den Stil "Styles" verwendet. Das flag PSH_WIZARD muss ebenfalls festgelegt werden. Das Singlethread-Apartmentmodell (STA) muss verwendet werden.
PSH_HASHELP (0x00000200) Lässt zu, dass Eigenschaftenblattseiten eine Hilfeschaltfläche anzeigen. Sie müssen auch das flag PSP_HASHELP in der PROPSHEETPAGE-Struktur der Seite festlegen, wenn die Seite erstellt wird. Wenn eine der ersten Eigenschaftenblattseiten eine Hilfeschaltfläche aktiviert, wird PSH_HASHELP automatisch festgelegt. Wenn keine der ersten Seiten eine Hilfeschaltfläche aktiviert, müssen Sie explizit PSH_HASHELP festlegen, wenn Sie auf allen Seiten, die später hinzugefügt werden können, Über Hilfeschaltflächen verfügen möchten. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_HEADER (0x00080000) Version 5.80 und höher. Gibt an, dass eine Headerbitmap mit einem Wizard97-Assistenten verwendet wird. Sie müssen auch das flag PSH_WIZARD97 festlegen. Wenn das PSH_USEHBMHEADER-Flag festgelegt ist, wird die Headerbitmap vom hbmHeader-Member abgerufen. Andernfalls wird die Headerbitmap aus dem pschildmHeader-Member abgerufen. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_HEADERBITMAP (0x08000000) Version 6.00 und höher. Der ps csvmHeader-Member gibt eine Bitmap an, die im Headerbereich angezeigt wird. Muss in Kombination mit PSH_AEROWIZARD verwendet werden.
PSH_MODELESS (0x00000400) Bewirkt, dass die PropertySheet-Funktion das Eigenschaftenblatt als modusloses Dialogfeld statt als modales Dialogfeld erstellt. Wenn dieses Flag festgelegt ist, wird PropertySheet sofort nach dem Erstellen des Dialogfelds zurückgegeben, und der Rückgabewert von PropertySheet ist das Fensterhandle für das Eigenschaftenblattdialogfeld. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_NOAPPLYNOW (0x00000080) Entfernt die Schaltfläche Übernehmen. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_NOCONTEXTHELP (0x02000000) Version 5.80 und höher. Entfernt die kontextbezogene Hilfeschaltfläche ("?"), die normalerweise auf der Beschriftungsleiste von Eigenschaftenblättern vorhanden ist. Dieses Flag ist für Assistenten ungültig. Unter Informationen zu Eigenschaftenblättern erfahren Sie, wie Sie die Hilfeschaltfläche der Beschriftungsleiste für frühere Versionen der allgemeinen Steuerelemente entfernen. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_NOMARGIN (0x10000000) Version 6.00 oder höher. Gibt an, dass kein Rand zwischen der Seite und dem Frame eingefügt wird. Muss in Kombination mit PSH_AEROWIZARD verwendet werden.
PSH_PROPSHEETPAGE (0x00000008) Verwendet den ppsp-Member und ignoriert den phpage-Member beim Erstellen der Seiten für das Eigenschaftenblatt.
PSH_PROPTITLE (0x00000001) Gibt an, dass pszCaption der Name der Eigenschaft ist, für die Eigenschaften angezeigt werden. Windows nimmt eine versions- und sprachabhängige Anpassung der Beschriftung vor. In englischer Sprache wird beispielsweise der Ausdruck "Eigenschaften für" einer nicht leeren pszCaption voranstehen (und wenn pszCaption eine leere Beschriftung erzeugt, ist der Titel einfach "Eigenschaften"). Wenn dieses Flag ausgelassen wird, wird pszCaption unverändert verwendet.
PSH_RESIZABLE (0x04000000) Ermöglicht es dem Assistenten, die Größe des Benutzers zu ändern. Schaltflächen zum Maximieren und Minimieren werden im Rahmen des Assistenten angezeigt, und der Rahmen kann verkleinern. Um dieses Flag zu verwenden, müssen Sie auch PSH_AEROWIZARD festlegen.
PSH_RTLREADING (0x00000800) Legt das Eigenschaftenblatt oder Assistentenfenster auf die Lesereihenfolge von rechts nach links (RTL) fest, die für Sprachen wie Hebräisch und Arabisch geeignet ist. Wenn dieses Flag nicht angegeben ist, werden Eigenschaftenblattfenster standardmäßig in der Lesereihenfolge von links nach rechts (LTR) angezeigt, und Assistentenfenster entsprechen der Lesereihenfolge der aktuellen Seite.
PSH_STRETCHWATERMARK (0x00040000) Streckt das Wasserzeichen in Assistenten97-Stil-Assistenten. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt. Dieses Stilflag ist nur enthalten, um Abwärtskompatibilität für bestimmte Anwendungen bereitzustellen. Die Verwendung wird nicht empfohlen und wird nur von den gängigen Steuerungsversionen 4.0 und 4.01 unterstützt. Bei allgemeinen Steuerelementen ab Version 5.80 wird dieses Flag ignoriert.
PSH_USECALLBACK (0x00000100) Ruft die durch den pfnCallback-Parameter angegebene Funktion auf, wenn bestimmte Ereignisse auftreten. Weitere Informationen finden Sie in der Beschreibung der RÜCKRUFFUNKTION PFNPROPSHEETCALLBACK.
PSH_USEHBMHEADER (0x00100000) Version 5.80. Ruft die Headerbitmap aus dem hbmHeader-Member anstelle des pschildmHeader-Elements ab. Außerdem müssen Sie entweder das PSH_AEROWIZARD- oder das PSH_WIZARD97-Flag zusammen mit dem PSH_HEADER-Flag festlegen.
PSH_USEHBMWATERMARK (0x00010000) Version 5.80. Ruft die Wasserzeichenbitmap aus dem hbmWatermark-Member anstelle des pschildmWatermark-Elements ab. Sie müssen auch PSH_WIZARD97 und PSH_WATERMARK festlegen. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_USEHICON (0x00000002) Verwendet hIcon als kleines Symbol in der Titelleiste des Eigenschaftenblattdialogfelds.
PSH_USEHPLWATERMARK (0x00020000) Version 5.80. Verwendet die HPALETTE-Struktur, auf die der hplWatermark-Member zeigt, anstelle der Standardpalette, um die Wasserzeichenbitmap und/oder Headerbitmap für einen Wizard97-Assistenten zu zeichnen. Sie müssen auch PSH_WIZARD97 und PSH_WATERMARK oder PSH_HEADER festlegen. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_USEICONID (0x00000004) Verwendet pszIcon als Namen der zu ladende Symbolressource und verwendet als kleines Symbol in der Titelleiste des Eigenschaftenblattdialogfelds.
PSH_USEPAGELANG (0x00200000) Version 5.80. Gibt an, dass die Sprache für das Eigenschaftenblatt aus der Ressource der ersten Seite übernommen wird. Diese Seite muss durch den Ressourcenbezeichner angegeben werden.
PSH_USEPSTARTPAGE (0x00000040) Verwendet das pStartPage-Element anstelle des nStartPage-Members, wenn die Anfangsseite des Eigenschaftenblatts angezeigt wird.
PSH_WATERMARK (0x00008000) Version 5.80. Gibt an, dass eine Wasserzeichenbitmap mit einem Wizard97-Assistenten auf Seiten mit dem PSP_HIDEHEADER Stil verwendet wird. Sie müssen auch das flag PSH_WIZARD97 festlegen. Die Wasserzeichenbitmap wird aus dem pschildmWatermark-Member abgerufen, es sei denn, PSH_USEHBMWATERMARK ist festgelegt. In diesem Fall wird die Headerbitmap vom hbmWatermark-Member abgerufen. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_WIZARD (0x00000020) Erstellt ein Eigenschaftenblatt des Assistenten. Wenn Sie PSH_AEROWIZARD verwenden, müssen Sie dieses Flag auch festlegen.
PSH_WIZARD97 (0x01000000) Version 5.80. Erstellt ein Eigenschaftenblatt im Assistenten97-Stil, das Bitmaps im Header der inneren Seiten und auf der linken Seite der äußeren Seiten unterstützt. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_WIZARDCONTEXTHELP (0x00001000) Fügt eine kontextbezogene Hilfeschaltfläche ("?") hinzu, die in der Regel in der Beschriftungsleiste eines Assistenten nicht vorhanden ist. Dieses Flag ist für reguläre Eigenschaftenblätter ungültig. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_WIZARDHASFINISH (0x00000010) Zeigt immer die Schaltfläche Fertig stellen im Assistenten an. Sie müssen auch entweder PSH_WIZARD, PSH_WIZARD97 oder PSH_AEROWIZARD festlegen.
PSH_WIZARD_LITE (0x00400000) Version 5.80. Verwendet den Stil Wizard-lite. Dieser Stil ähnelt der Darstellung PSH_WIZARD97, wird aber ähnlich wie PSH_WIZARD implementiert. Es gibt einige Einschränkungen hinsichtlich der Formatierung der Seiten. Es gibt z. B. keine erzwungenen Rahmen, und der PSH_WIZARD_LITE Format zeichnet das Wasserzeichen und die Headerbitmaps nicht für Sie so wie Wizard97. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.

hwndParent

Typ: HWND

Handle für das Besitzerfenster des Eigenschaftenblatts.

hInstance

Typ: HINSTANCE

Handle für die Instanz, aus der das Symbol, die Titelzeichenfolgenressource, der Startseitenname, die Headerbitmap oder das Wasserzeichen geladen werden sollen. Wenn das PszIcon-, pszCaption-, pStartPage-, pschildmHeader- oder pschildmWatermark-Element eine zu ladende Ressource identifiziert, muss dieser Member angegeben werden.

hIcon

Typ: HICON

Behandeln Sie das Symbol, das als kleines Symbol in der Titelleiste des Eigenschaftenblattdialogfelds verwendet werden soll. Dieser Member wird verwendet, wenn das dwFlags-Element PSH_USEHICON enthält. Dieser Member wird mit pszIcon als Union deklariert.

pszIcon

Typ: LPCTSTR

Symbolressource, die als kleines Symbol in der Titelleiste des Eigenschaftenblattdialogfelds verwendet werden soll. Dieser Member wird verwendet, wenn das dwFlags-Element PSH_USEICONID enthält. Dieser Member kann entweder den Bezeichner der Symbolressource oder die Adresse der Zeichenfolge angeben, die den Namen der Symbolressource angibt. In beiden Fällen wird das Symbol aus der vom hInstance-Member bereitgestellten Instanz geladen. Dieser Member wird mit hIcon als Union deklariert.

pszCaption

Typ: LPCTSTR

Titel des Dialogfelds "Eigenschaftenblatt". Dieser Member kann entweder den Bezeichner einer Zeichenfolgenressource (geladen aus der vom hInstance-Member angegebenen Instanz) oder die Adresse einer Zeichenfolge angeben, die den Titel angibt. Wenn der dwFlags-Member PSH_PROPTITLE enthält, wird die Zeichenfolge Eigenschaften für am Anfang des Titels eingefügt. Dieses Feld wird für Assistenten97 ignoriert. Bei Einem Assistenten wird die Zeichenfolge allein für die Beschriftung verwendet, unabhängig davon, ob das PSH_PROPTITLE-Flag festgelegt ist.

nPages

Typ: UINT

Anzahl der Eigenschaftenblattseiten, die entweder im ppsp- oder phpage-Array bereitgestellt werden.

nStartPage

Typ: UINT

Nullbasierter Index der ersten Seite, die angezeigt wird, wenn das Eigenschaftenblattdialogfeld erstellt wird. Dieser Member wird verwendet, wenn der dwFlags-Member das flag PSH_USEPSTARTPAGE nicht enthält. Dieser Member wird mit pStartPage als Union deklariert.

pStartPage

Typ: LPCTSTR

Name der Anfangsseite, die beim Erstellen des Eigenschaftenblattdialogfelds angezeigt wird. Dieser Member wird verwendet, wenn der dwFlags-Member das flag PSH_USESTARTPAGE enthält. Dieser Member kann entweder den Bezeichner einer Zeichenfolgenressource (geladen aus der vom hInstance-Member angegebenen Instanz) oder die Adresse einer Zeichenfolge angeben, die den Namen angibt. Der Name der Startseite wird mit den Beschriftungen der Seiten abgegleichen. Dieser Member wird mit nStartPage als Union deklariert.

ppsp

Typ: LPCPROPSHEETPAGE

Zeiger auf ein Array von PROPSHEETPAGE-Strukturen, die die Seiten im Eigenschaftenblatt definieren. Wenn der dwFlags-Member PSH_PROPSHEETPAGE nicht enthält, wird dieser Member ignoriert. Beachten Sie, dass die PROPSHEETPAGE-Struktur eine variable Größe aufweist. Anwendungen, die das Array analysieren, auf das ppsp zeigt, müssen die Größe jeder Seite berücksichtigen. Dieser Member wird als Union mit phpage deklariert.

phpage

Typ: HPROPSHEETPAGE *

Zeiger auf ein Array von Handles auf die Eigenschaftenblattseiten. Dieser Member wird verwendet, wenn der dwFlags-Member keine PSH_PROPSHEETPAGE enthält. Jedes Handle muss durch einen vorherigen Aufruf der CreatePropertySheetPage-Funktion erstellt worden sein. Wenn die PropertySheet-Funktion zurückgegeben wird, wurden alle HPROPSHEETPAGE-Handles im phpage-Array zerstört. Dieser Member wird als Union mit ppsp deklariert.

pfnCallback

Typ: PFNPROPSHEETCALLBACK

Zeiger auf eine anwendungsdefinierte Rückruffunktion, die aufgerufen wird, wenn bestimmte Ereignisse auftreten. Weitere Informationen zur Rückruffunktion finden Sie in der Beschreibung der RÜCKRUFFUNKTION PFNPROPSHEETCALLBACK. Wenn der dwFlags-Member keine PSH_USECALLBACK enthält, wird dieser Member ignoriert.

hbmWatermark

Typ: HBITMAP

Version 5.80 oder höher. Handle für die Wasserzeichenbitmap. Wenn der dwFlags-Member keine PSH_USEHBMWATERMARK enthält, wird dieser Member ignoriert.

psmusWatermark

Typ: LPCTSTR

Version 5.80 oder höher. Bitmapressource, die als Wasserzeichen verwendet werden soll. Dieser Member kann entweder den Bezeichner der Bitmapressource oder die Adresse der Zeichenfolge angeben, die den Namen der Bitmapressource angibt. Wenn das dwFlags-Member PSH_USEHBMWATERMARK, wird dieser Member ignoriert.

hplWatermark

Typ: HPALETTE

Version 5.80 oder höher. HPALETTE-Struktur, die zum Zeichnen der Wasserzeichenbitmap und/oder Headerbitmap verwendet wird. Wenn das dwFlags-Member keine PSH_USEHPLWATERMARK enthält, wird dieser Member ignoriert.

hbmHeader

Typ: HBITMAP

Version 5.80 oder höher. Handle für die Headerbitmap. Wenn das dwFlags-Member keine PSH_USEHBMHEADER enthält, wird dieser Member ignoriert.

pswittmHeader

Typ: LPCSTR

Version 5.80 oder höher. Bitmapressource, die als Header verwendet werden soll. Dieser Member kann entweder den Bezeichner der Bitmapressource oder die Adresse der Zeichenfolge angeben, die den Namen der Bitmapressource angibt. Wenn das dwFlags-Member PSH_USEHBMHEADER, wird dieser Member ignoriert.

Bemerkungen

Wenn der Benutzer eine Einstellung wie große Schriftarten auswählt, wodurch das Dialogfeld vergrößert wird, wird auch das Wasserzeichen vergrößert, das auf den Seiten "Start" und "Fertig stellen" gestrichen wird. Größe und Position der ursprünglichen Bitmap bleiben unverändert. Der zusätzliche Bereich wird mit der Farbe des Pixels in der oberen linken Ecke der Bitmap gefüllt.

Die PSH_WIZARD, PSH_WIZARD97 und PSH_WIZARD_LITE sind gegenseitig inkompatibel. Es sollte nur eines dieser Formatflags festgelegt werden. PSH_AEROWIZARD sollten mit der PSH_WIZARD.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Nur Server [ 2003-Desktop-Apps]
Header Prsht.h
Unicode- und ANSI-Name PROPSHEETHEADERW (Unicode) und PROPSHEETHEADERA (ANSI)