PROPSHEETHEADERA_V2-Struktur (prsht.h)

Definiert den Rahmen und die Seiten eines Eigenschaftenblatts.

Hinweis

Diese Struktur ist nicht für die direkte Verwendung im Code vorgesehen. Verwenden Sie stattdessen die STRUKTUR PROPSHEETHEADER .

Syntax

typedef struct _PROPSHEETHEADERA_V2 {
  union {
    HBITMAP hbmWatermark;
    LPCSTR  pszbmWatermark;
  } DUMMYUNIONNAME4;
  HPALETTE hplWatermark;
  union {
    HBITMAP hbmHeader;
    LPCSTR  pszbmHeader;
  } DUMMYUNIONNAME5;
} PROPSHEETHEADERA_V2, *LPPROPSHEETHEADERA_V2;

Members

DUMMYUNIONNAME4

DUMMYUNIONNAME4.hbmWatermark

Typ: HBITMAP

Version 5.80 oder höher. Handle mit der Bitmap des Wasserzeichens. Wenn der dwFlags-Member nicht PSH_USEHBMWATERMARK enthält, wird dieser Member ignoriert.

DUMMYUNIONNAME4.pszbmWatermark

Typ: LPCTSTR

Version 5.80 oder höher. Bitmapressource, die als Wasserzeichen verwendet werden soll. Dieses Element 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 Bitmap des Wasserzeichens und/oder der Kopfzeile verwendet wird. Wenn der dwFlags-Member nicht PSH_USEHPLWATERMARK enthält, wird dieser Member ignoriert.

DUMMYUNIONNAME5

DUMMYUNIONNAME5.hbmHeader

Typ: HBITMAP

Version 5.80 oder höher. Handle mit der Header-Bitmap. Wenn der dwFlags-Member nicht PSH_USEHBMHEADER enthält, wird dieser Member ignoriert.

DUMMYUNIONNAME5.pszbmHeader

Typ: LPCSTR

Version 5.80 oder höher. Bitmapressource, die als Header verwendet werden soll. Dieses Element kann entweder den Bezeichner der Bitmapressource oder die Adresse der Zeichenfolge angeben, die den Namen der Bitmapressource angibt. Wenn das dwFlags-Element PSH_USEHBMHEADER enthält, wird dieses Element ignoriert.

Hinweise

Wenn der Benutzer eine Einstellung wie große Schriftarten wählt, die das Dialogfeld vergrößert, wird auch das Wasserzeichen, das auf den Anfangs- und Endseiten gemalt wird, vergrößert. Die 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.

Beachten Sie, dass mehrere Member dieser Struktur nur für Comctl32.dll Versionen 4.71 und höher unterstützt werden. Sie können diese Member aktivieren, indem Sie eine der folgenden Elemente in Ihren Header einfügen.

#define _WIN32_IE 0x0400 // For version 4.71

oder

#define _WIN32_IE 0x0500 // For version 5.80

Sie müssen die Struktur jedoch mit ihrer Größe initialisieren. Wenn Sie die Größe der derzeit definierten Struktur verwenden, wird die Anwendung möglicherweise nicht mit den früheren Versionen von Comctl32.dll ausgeführt, die eine kleinere Struktur erwarten. Dies schließt alle Systeme mit Windows 95 oder Microsoft Windows NT 4.0 ein, auf denen das Internet Explorer 4.0 oder höher nicht installiert ist. Sie können Ihre Anwendung unter Versionen vor 4.71 Comctl32.dll ausführen, indem Sie die entsprechende Versionsnummer definieren. Dies kann jedoch zu Problemen führen, wenn Ihre Anwendung auch auf Systemen mit neueren Versionen ausgeführt werden muss.

Sie können mit allen Comctl32.dll Versionen kompatibel bleiben, indem Sie die aktuellen Headerdateien verwenden und die Größe der PROPSHEETHEADER-Struktur entsprechend festlegen. Bevor Sie die Struktur initialisieren, verwenden Sie die DllGetVersion-Funktion , um zu bestimmen, welche Comctl32.dll Version auf dem System installiert ist. Wenn es sich um Version 4.71 oder höher handelt, verwenden Sie

psh.dwSize = sizeof(PROPSHEETHEADER);

, um den dwSize-Member zu initialisieren. Bei früheren Versionen wird die Größe der Vor-4.71-Struktur durch die PROPSHEETHEADER_V1_SIZE Konstante angegeben. Zweck

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

Die Stile PSH_WIZARD, PSH_WIZARD97 und PSH_WIZARD_LITE sind inkompatibel. Es sollte nur eines dieser Stilflags festgelegt werden. PSH_AEROWIZARD sollte mit PSH_WIZARD kombiniert werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	prsht.h