PROPSHEETHEADER-Struktur

  • Artikel

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;

Member

dwSize

Art: 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

Art: 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 Standardbedeutung für alle Strukturmember und erstellt ein normales Eigenschaftenblatt. Dieses Flag hat den Wert 0 und wird nicht mit anderen Flags kombiniert.
PSH_AEROWIZARD (0x00004000) Version 6.00 und höher. Erstellt ein Assistenteneigenschaftenblatt, das das Aero-Format verwendet. Das PSH_WIZARD-Flag muss ebenfalls festgelegt werden. Das Sta-Modell (Single-Threaded Apartment) muss verwendet werden.
PSH_HASHELP (0x00000200) Ermöglicht eigenschaftenblattseiten das Anzeigen einer Hilfeschaltfläche . Sie müssen auch das PSP_HASHELP-Flag in der PROPSHEETPAGE-Struktur der Seite festlegen, wenn die Seite erstellt wird. Wenn eine der anfänglichen Eigenschaftenblattseiten eine Hilfeschaltfläche aktiviert, wird PSH_HASHELP automatisch festgelegt. Wenn keine der anfänglichen Seiten eine Hilfeschaltfläche aktiviert, müssen Sie explizit PSH_HASHELP festlegen, wenn Sie Hilfeschaltflächen auf allen Seiten verwenden möchten, die später möglicherweise hinzugefügt werden. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_HEADER (0x00080000) Version 5.80 und höher. Gibt an, dass eine Header-Bitmap mit einem Wizard97-Assistenten verwendet wird. Sie müssen auch das PSH_WIZARD97-Flag festlegen. Wenn das PSH_USEHBMHEADER-Flag festgelegt ist, wird die Header-Bitmap vom hbmHeader-Element abgerufen. Andernfalls wird die Header-Bitmap vom pszbmHeader-Element abgerufen. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_HEADERBITMAP (0x08000000) Version 6.00 und höher. Das pszbmHeader-Element 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 anstatt als modales Dialogfeld erstellt. Wenn dieses Flag festgelegt ist, gibt PropertySheet sofort nach dem Erstellen des Dialogfelds zurück, und der Rückgabewert aus PropertySheet ist das Fensterhandle zum Dialogfeld Eigenschaftenblatt. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_NOAPPLYNOW (0x00000080) Entfernt die Schaltfläche Anwenden . Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_NOCONTEXTHELP (0x02000000) Version 5.80 und höher. Entfernt die kontextabhängige Hilfeschaltfläche ("?"), die normalerweise auf der Untertitel Leiste von Eigenschaftenblättern vorhanden ist. Dieses Flag ist für Assistenten ungültig. Informationen zum Entfernen der Untertitel leisten-Schaltfläche "Hilfe" für frühere Versionen der allgemeinen Steuerelemente finden Sie unter Informationen zu Eigenschaftenblättern. 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 das ppsp-Element und ignoriert das phpage-Element beim Erstellen der Seiten für das Eigenschaftenblatt.
PSH_PROPTITLE (0x00000001) Gibt an, dass pszCaption der Name des Dings ist, für das Eigenschaften angezeigt werden. Windows nimmt eine versions- und sprachabhängige Anpassung am Untertitel vor. In englischer Sprache wird beispielsweise der Ausdruck "Eigenschaften für" einem nicht erlösenden pszCaption vorangestellt (und wenn pszCaption eine leere Untertitel erzeugt, lautet der Titel einfach "Eigenschaften". Wenn dieses Flag nicht angegeben wird, wird die pszCaption unverändert verwendet.
PSH_RESIZABLE (0x04000000) Ermöglicht es dem Benutzer, die Größe des Assistenten zu ändern. Schaltflächen maximieren und minimieren werden im Rahmen des Assistenten angezeigt, und der Frame ist annehmbar. Um dieses Flag zu verwenden, müssen Sie auch PSH_AEROWIZARD festlegen.
PSH_RTLREADING (0x00000800) Legt das Eigenschaftenblatt oder das 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 die Eigenschaftenblattfenster standardmäßig auf die Lesereihenfolge von links nach rechts (LTR) festgelegt, und die Assistentenfenster entsprechen der Lesereihenfolge der aktuellen Seite.
PSH_STRETCHWATERMARK (0x00040000) Dehnt das Wasserzeichen in Assistenten im Wizard97-Stil aus. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt. Dieses Formatvorlagenflag ist nur enthalten, um abwärtskompatibilität für bestimmte Anwendungen zu gewährleisten. Die Verwendung wird nicht empfohlen und wird nur von den gängigen Steuerelementversionen 4.0 und 4.01 unterstützt. Bei gängigen Steuerelementen, Version 5.80 und höher, wird dieses Flag ignoriert.
PSH_USECALLBACK (0x00000100) Ruft die vom 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 Header-Bitmap vom hbmHeader-Member statt vom pszbmHeader-Element ab. Sie müssen auch entweder das PSH_AEROWIZARD-Flag oder das PSH_WIZARD97-Flag zusammen mit dem PSH_HEADER-Flag festlegen.
PSH_USEHBMWATERMARK (0x00010000) Version 5.80. Ruft die Bitmap des Wasserzeichens vom hbmWatermark-Member anstelle des pszbmWatermark-Elements ab. Außerdem müssen Sie 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 Dialogfelds Eigenschaftenblatt.
PSH_USEHPLWATERMARK (0x00020000) Version 5.80. Verwendet die HPALETTE-Struktur , auf die vom hplWatermark-Member anstelle der Standardpalette verwiesen wird, um die Wasserzeichen-Bitmap und/oder die Header-Bitmap für einen Assistenten97 zu zeichnen. Sie müssen auch PSH_WIZARD97 festlegen und PSH_WATERMARK oder PSH_HEADER. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_USEICONID (0x00000004) Verwendet pszIcon als Namen der Symbolressource, die geladen und als kleines Symbol in der Titelleiste des Eigenschaftenblattdialogfelds verwendet werden soll.
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 erste Seite des Eigenschaftenblatts angezeigt wird.
PSH_WATERMARK (0x00008000) Version 5.80. Gibt an, dass eine Wasserzeichen-Bitmap mit einem Assistenten97 auf Seiten verwendet wird, die das format "PSP_HIDEHEADER" aufweisen. Sie müssen auch das flag PSH_WIZARD97 festlegen. Die Bitmap des Wasserzeichens wird vom pszbmWatermark-Element abgerufen, es sei denn, PSH_USEHBMWATERMARK festgelegt ist. In diesem Fall wird die Headerbitbitbit aus dem hbmWatermark-Element 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 auch dieses Flag festlegen.
PSH_WIZARD97 (0x01000000) Version 5.80. Erstellt ein Eigenschaftenblatt im Wizard97-Stil, das Bitmaps in der Kopfzeile von innen und auf der linken Seite von äußeren Seiten unterstützt. Dieses Flag wird in Verbindung mit PSH_AEROWIZARD nicht unterstützt.
PSH_WIZARDCONTEXTHELP (0x00001000) Fügt eine kontextabhängige Hilfeschaltfläche ("?") hinzu, die normalerweise in der Untertitel leiste eines Assistenten fehlt. Dieses Flag ist für reguläre Eigenschaftenblätter nicht gü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. Außerdem müssen Sie entweder PSH_WIZARD, PSH_WIZARD97 oder PSH_AEROWIZARD festlegen.
PSH_WIZARD_LITE (0x00400000) Version 5.80. Verwendet den Wizard-lite-Stil. Dieser Stil ähnelt PSH_WIZARD97, wird aber ähnlich wie PSH_WIZARD implementiert. Es gibt einige Einschränkungen hinsichtlich der Formatierung der Seiten. Für instance gibt es keine erzwungenen Rahmen, und die PSH_WIZARD_LITE Stil zeichnet nicht die Wasserzeichen- und Kopfzeilenbitbitbits wie Wizard97 für Sie. 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 mit dem instance, aus dem das Symbol, die Titelzeichenfolgenressource, der Name der Startseite, die Kopfzeilenbitbitbit oder das Wasserzeichen geladen werden sollen. Wenn das Element pszIcon, pszCaption, pStartPage, pszbmHeader oder pszbmWatermark eine zu ladende Ressource identifiziert, muss dieser Member angegeben werden.

hIcon

Typ: HICON

Handle zum 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. Dieses Element wird als Union mit pszIcon 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. Dieses Element 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 dem vom hInstance-Member bereitgestellten instance geladen. Dieses Element wird als Union mit hIcon deklariert.

pszCaption

Typ: LPCTSTR

Titel des Eigenschaftenblattdialogfelds. Dieser Member kann entweder den Bezeichner einer Zeichenfolgenressource (geladen aus dem vom hInstance-Member angegebenen instance) 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 Assistenten von Wizard97 ignoriert. Für Aero-Assistenten wird die Zeichenfolge allein für die Untertitel verwendet, unabhängig davon, ob das flag PSH_PROPTITLE 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, der beim Erstellen des Eigenschaftenblattdialogfelds angezeigt wird. Dieses Element wird verwendet, wenn der dwFlags-Member das flag PSH_USEPSTARTPAGE nicht enthält. Dieses Element wird mit pStartPage als Union deklariert.

pStartPage

Typ: LPCTSTR

Name der ersten Seite, die beim Erstellen des Eigenschaftenblattdialogfelds angezeigt wird. Dieser Member wird verwendet, wenn das dwFlags-Element das flag PSH_USESTARTPAGE enthält. Dieser Member kann entweder den Bezeichner einer Zeichenfolgenressource (geladen aus dem vom hInstance-Member angegebenen instance) oder die Adresse einer Zeichenfolge angeben, die den Namen angibt. Der Name der Startseite wird mit den Beschriftungen der Seiten abgeglichen. 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 keine PSH_PROPSHEETPAGE 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 verweist, müssen die Größe der einzelnen Seiten 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, werden alle HPROPSHEETPAGE-Handles im phpage-Array zerstört. Dieses Element 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 Bitmap des Wasserzeichens. Wenn der dwFlags-Member keine PSH_USEHBMWATERMARK enthält, wird dieser Member ignoriert.

pszbmWatermark

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 der dwFlags-Member PSH_USEHBMWATERMARK enthält, wird dieser Member ignoriert.

hplWatermark

Typ: HPALETTE

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

hbmHeader

Typ: HBITMAP

Version 5.80 oder höher. Handle für die Headerbitbitbit. Wenn das dwFlags-Element nicht PSH_USEHBMHEADER enthält, wird dieses Element ignoriert.

pszbmHeader

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 der dwFlags-Member PSH_USEHBMHEADER enthält, wird dieser Member ignoriert.

Bemerkungen

Wenn der Benutzer eine Einstellung wie große Schriftarten wählt, die das Dialogfeld vergrößert, wird auch das Wasserzeichen vergrößert, das auf den Anfangs- und Endseiten gezeichnet 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 Stile PSH_WIZARD, PSH_WIZARD97 und PSH_WIZARD_LITE sind gegenseitig inkompatibel. Es sollte nur eines dieser Stilflags festgelegt werden. PSH_AEROWIZARD sollte mit PSH_WIZARD kombiniert werden.

Anforderungen

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