struttura PROPSHEETHEADERW_V2 (prsht.h)

Definisce la cornice e le pagine di una finestra delle proprietà.

Nota

Questa struttura non deve essere usata direttamente nel codice. Utilizzare invece la struttura PROPSHEETHEADER .

Sintassi

typedef struct _PROPSHEETHEADERW_V2 {
  union {
    HBITMAP hbmWatermark;
    LPCWSTR pszbmWatermark;
  } DUMMYUNIONNAME4;
  HPALETTE hplWatermark;
  union {
    HBITMAP hbmHeader;
    LPCWSTR pszbmHeader;
  } DUMMYUNIONNAME5;
} PROPSHEETHEADERW_V2, *LPPROPSHEETHEADERW_V2;

Members

DUMMYUNIONNAME4

DUMMYUNIONNAME4.hbmWatermark

Tipo: HBITMAP

Versione 5.80 o successiva. Handle per 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 per la 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 Tipi di carattere di grandi dimensioni, che ingrandisce la finestra di dialogo, la filigrana che viene disegnata sulle pagine iniziali e finali verrà ingrandita. 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 una delle opzioni seguenti 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 dispongono di Internet Explorer 4.0 o versioni successive installate. È possibile eseguire l'applicazione nelle versioni precedenti alla 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 utilizzando 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 è installata nel sistema. Se è la 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 fornite dalla costante PROPSHEETHEADER_V1_SIZE. Uso

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

Gli stili PSH_WIZARD, PSH_WIZARD97 e PSH_WIZARD_LITE sono reciprocamente incompatibili. È necessario impostare solo uno di questi flag di stile. PSH_AEROWIZARD devono essere combinati con PSH_WIZARD.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	prsht.h