PROPSHEETHEADERA_V2 struttura (prsht.h)

Definisce la cornice e le pagine di un foglio delle proprietà.

Sintassi

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

Tipo: HBITMAP

Versione 5.80 o successiva. Gestire la bitmap della filigrana. Se il membro dwFlags non include PSH_USEHBMWATERMARK, questo membro viene ignorato.

DUMMYUNIONNAME4.pszbmWatermark

Tipo: LPCTSTR

Versione 5.80 o successiva. Risorsa bitmap da usare come filigrana. Questo membro può specificare l'identificatore della risorsa bitmap o l'indirizzo della stringa che specifica il nome della risorsa bitmap. Se il membro dwFlags include PSH_USEHBMWATERMARK, questo membro viene ignorato.

hplWatermark

Tipo: HPALETTE

Versione 5.80 o successiva. Struttura HPALETTE usata per disegnare la bitmap della filigrana e/o la bitmap dell'intestazione. Se il membro dwFlags non include PSH_USEHPLWATERMARK, questo membro viene ignorato.

DUMMYUNIONNAME5

DUMMYUNIONNAME5.hbmHeader

Tipo: HBITMAP

Versione 5.80 o successiva. Handle nella bitmap dell'intestazione. Se il membro dwFlags non include PSH_USEHBMHEADER, questo membro viene ignorato.

DUMMYUNIONNAME5.pszbmHeader

Tipo: LPCSTR

Versione 5.80 o successiva. Risorsa bitmap da usare come intestazione. Questo membro può specificare l'identificatore della risorsa bitmap o l'indirizzo della stringa che specifica il nome della risorsa bitmap. Se il membro dwFlags include PSH_USEHBMHEADER, questo membro viene ignorato.

Commenti

Se l'utente sceglie un'impostazione come Caratteri di grandi dimensioni, che ingrandisce la finestra di dialogo, la filigrana dipinta nelle pagine di inizio e fine verrà anche ampliata. Le dimensioni e la posizione della bitmap originale rimarranno invariate. L'area aggiuntiva verrà riempita con il colore del pixel nell'angolo superiore sinistro della bitmap.

Si noti che diversi membri di questa struttura sono supportati solo per Comctl32.dll versioni 4.71 e successive. È possibile abilitare questi membri includendo uno dei seguenti elementi nell'intestazione.

#define _WIN32_IE 0x0400 // For version 4.71

oppure

#define _WIN32_IE 0x0500 // For version 5.80

Tuttavia, è necessario inizializzare la struttura con le relative dimensioni. Se si usano le dimensioni della struttura attualmente definita, l'applicazione potrebbe non essere eseguita con le versioni precedenti di Comctl32.dll, che prevedono una struttura più piccola. Sono inclusi tutti i sistemi con Windows 95 o Microsoft Windows NT 4.0 che non hanno Internet Explorer 4.0 o versioni successive installate. È possibile eseguire l'applicazione nelle versioni pre-4.71 di Comctl32.dll definendo il numero di versione appropriato. Tuttavia, questo può causare problemi se l'applicazione deve essere eseguita anche nei sistemi con versioni più recenti.

È possibile rimanere compatibili con tutte le versioni Comctl32.dll usando i file di intestazione correnti e impostando le dimensioni della struttura PROPSHEETHEADER in modo appropriato. Prima di inizializzare la struttura, usare la funzione DllGetVersion per determinare quale Comctl32.dll versione viene installata nel sistema. Se è versione 4.71 o successiva, usare

psh.dwSize = sizeof(PROPSHEETHEADER);

per inizializzare il membro dwSize . Per le versioni precedenti, le dimensioni della struttura pre-4.71 sono date dalla costante PROPSHEETHEADER_V1_SIZE. Uso

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

Gli stili PSH_WIZARD, PSH_WIZARD97 e PSH_WIZARD_LITE sono reciprocamente incompatibili. È consigliabile impostare solo uno di questi flag di stile. PSH_AEROWIZARD deve essere combinato con PSH_WIZARD.

Requisiti