Struttura PROPSHEETHEADER
Definisce la cornice e le pagine di una finestra delle proprietà.
Sintassi
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
Tipo: DWORD
Dimensioni, in byte, di questa struttura. Il gestore della finestra delle proprietà utilizza questo membro per determinare quale versione della struttura PROPSHEETHEADER in uso. Per ulteriori informazioni, vedere la sezione Osservazioni.
dwFlags
Tipo: DWORD
Flag che indicano le opzioni da utilizzare durante la creazione della pagina della finestra delle proprietà. Questo membro può essere una combinazione dei valori seguenti.
| Valore | Significato |
|---|---|
| PSH_DEFAULT (0x00000000) | Usa il significato predefinito per tutti i membri della struttura e crea una normale finestra delle proprietà. Questo flag ha un valore pari a zero e non è combinato con altri flag. |
| PSH_AEROWIZARD (0x00004000) | Versione 6.00 e successive. Crea una finestra delle proprietà della procedura guidata che utilizza lo stile Aero. È inoltre necessario impostare il flag PSH_WIZARD. È necessario usare il modello apartment a thread singolo (STA). |
| PSH_HASHELP (0x00000200) | Consente alle pagine della finestra delle proprietà di visualizzare un pulsante ? È inoltre necessario impostare il flag PSP_HASHELP nella struttura PROPSHEETPAGE della pagina al momento della creazione della pagina. Se una delle pagine iniziali della finestra delle proprietà abilita un pulsante ? PSH_HASHELP verrà impostata automaticamente. Se nessuna delle pagine iniziali abilita un pulsante ? è necessario impostare in modo esplicito PSH_HASHELP se si desidera avere pulsanti Guida in tutte le pagine che potrebbero essere aggiunte in un secondo momento. Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_HEADER (0x00080000) | Versione 5.80 e successive. Indica che verrà usata una bitmap di intestazione con una procedura guidata Wizard97. È inoltre necessario impostare il flag di PSH_WIZARD97. Se il flag PSH_USEHBMHEADER è impostato, la bitmap dell'intestazione viene ottenuta dal membro hbmHeader . In caso contrario, la bitmap dell'intestazione viene ottenuta dal membro pszbmHeader . Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_HEADERBITMAP (0x08000000) | Versione 6.00 e successive. Il membro pszbmHeader specifica una bitmap visualizzata nell'area di intestazione. Deve essere utilizzato in combinazione con PSH_AEROWIZARD. |
| PSH_MODELESS (0x00000400) | Fa sì che la funzione PropertySheet crei la finestra delle proprietà come finestra di dialogo senza modalità anziché come finestra di dialogo modale. Quando questo flag è impostato, PropertySheet viene restituito immediatamente dopo la creazione della finestra di dialogo e il valore restituito da PropertySheet corrisponde all'handle di finestra di dialogo della finestra di dialogo della finestra delle proprietà. Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_NOAPPLYNOW (0x00000080) | Rimuove il pulsante Applica . Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_NOCONTEXTHELP (0x02000000) | Versione 5.80 e successive. Rimuove il pulsante della Guida sensibile al contesto ("?"), che in genere è presente nella barra didascalia delle finestre delle proprietà. Questo flag non è valido per le procedure guidate. Per informazioni su come rimuovere il pulsante della Guida della barra didascalia per le versioni precedenti dei controlli comuni, vedere Informazioni sulle finestre delle proprietà. Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_NOMARGIN (0x10000000) | Versione 6.00 o successiva. Specifica che non viene inserito alcun margine tra la pagina e il frame. Deve essere utilizzato in combinazione con PSH_AEROWIZARD. |
| PSH_PROPSHEETPAGE (0x00000008) | Usa il membro ppsp e ignora il membro phpage durante la creazione delle pagine per la finestra delle proprietà. |
| PSH_PROPTITLE (0x00000001) | Indica che pszCaption è il nome dell'elemento per cui vengono visualizzate le proprietà. Windows apporta una regolazione dipendente dalla versione e dalla lingua al didascalia. Ad esempio, in inglese, la frase "Properties for" viene anteporta a una pszCaption non vuota (e se pszCaption produce un didascalia vuoto, il titolo è semplicemente "Proprietà"). Se questo flag viene omesso, viene usato pszCaption senza modifica. |
| PSH_RESIZABLE (0x04000000) | Consente il ridimensionamento della procedura guidata da parte dell'utente. Ingrandisci e riduci a icona i pulsanti vengono visualizzati nella cornice della procedura guidata e la cornice è ridimensionabile. Per usare questo flag, è necessario impostare anche PSH_AEROWIZARD. |
| PSH_RTLREADING (0x00000800) | Imposta la finestra delle proprietà o la finestra della procedura guidata sull'ordine di lettura da destra a sinistra (RTL), appropriato per lingue come l'ebraico e l'arabo. Se questo flag non viene specificato, per impostazione predefinita le finestre della finestra delle proprietà vengono impostate sull'ordine di lettura da sinistra a destra (LTR) e le finestre della procedura guidata corrispondono all'ordine di lettura della pagina corrente. |
| PSH_STRETCHWATERMARK (0x00040000) | Estende la filigrana nelle procedure guidate di stile Wizard97. Questo flag non è supportato in combinazione con PSH_AEROWIZARD. Questo flag di stile è incluso solo per garantire la compatibilità con le versioni precedenti per determinate applicazioni. L'uso non è consigliato ed è supportato solo dalle versioni 4.0 e 4.01 dei controlli comuni. Con i controlli comuni versione 5.80 e successive, questo flag viene ignorato. |
| PSH_USECALLBACK (0x00000100) | Chiama la funzione specificata dal parametro pfnCallback quando si verificano determinati eventi. Per altre informazioni, vedere la descrizione della funzione di callback PFNPROPSHEETCALLBACK . |
| PSH_USEHBMHEADER (0x00100000) | Versione 5.80. Ottiene la bitmap dell'intestazione dal membro hbmHeader anziché dal membro pszbmHeader . È inoltre necessario impostare il flag di PSH_AEROWIZARD o il flag di PSH_WIZARD97 insieme al flag PSH_HEADER. |
| PSH_USEHBMWATERMARK (0x00010000) | Versione 5.80. Ottiene la bitmap filigrana dal membro hbmWatermark anziché dal membro pszbmWatermark . È inoltre necessario impostare PSH_WIZARD97 e PSH_WATERMARK. Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_USEHICON (0x00000002) | Usa hIcon come icona piccola nella barra del titolo della finestra di dialogo della finestra di dialogo della finestra di proprietà. |
| PSH_USEHPLWATERMARK (0x00020000) | Versione 5.80. Usa la struttura HPALETTE a cui punta il membro hplWatermark anziché la tavolozza predefinita per disegnare la bitmap della filigrana e/o la bitmap di intestazione per una procedura guidata wizard97. È inoltre necessario impostare PSH_WIZARD97 e PSH_WATERMARK o PSH_HEADER. Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_USEICONID (0x00000004) | Usa pszIcon come nome della risorsa icona per caricare e usare come icona piccola nella barra del titolo della finestra di dialogo del foglio delle proprietà. |
| PSH_USEPAGELANG (0x00200000) | Versione 5.80. Specifica che la lingua per il foglio delle proprietà verrà presa dalla risorsa della prima pagina. Tale pagina deve essere specificata dall'identificatore di risorsa. |
| PSH_USEPSTARTPAGE (0x00000040) | Usa il membro pStartPage anziché il membro nStartPage durante la visualizzazione della pagina iniziale del foglio delle proprietà. |
| PSH_WATERMARK (0x00008000) | Versione 5.80. Specifica che una bitmap filigrana verrà usata con una procedura guidata Wizard97 nelle pagine con lo stile PSP_HIDEHEADER. È anche necessario impostare il flag di PSH_WIZARD97. La bitmap della filigrana viene ottenuta dal membro pszbmWatermark , a meno che non sia impostata PSH_USEHBMWATERMARK. In tal caso, la bitmap dell'intestazione viene ottenuta dal membro hbmWatermark . Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_WIZARD (0x00000020) | Crea una finestra delle proprietà della procedura guidata. Quando si usa PSH_AEROWIZARD, è necessario impostare anche questo flag. |
| PSH_WIZARD97 (0x01000000) | Versione 5.80. Crea un foglio delle proprietà di stile Wizard97, che supporta le bitmap nell'intestazione delle pagine interne e sul lato sinistro delle pagine esterne. Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_WIZARDCONTEXTHELP (0x00001000) | Aggiunge un pulsante della Guida sensibile al contesto ("?"), che in genere è assente dalla barra didascalia di una procedura guidata. Questo flag non è valido per i fogli delle proprietà regolari. Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
| PSH_WIZARDHASFINISH (0x00000010) | Visualizza sempre il pulsante Fine nella procedura guidata. È anche necessario impostare PSH_WIZARD, PSH_WIZARD97 o PSH_AEROWIZARD. |
| PSH_WIZARD_LITE (0x00400000) | Versione 5.80. Usa lo stile Wizard-Lite. Questo stile è simile all'aspetto PSH_WIZARD97, ma viene implementato molto come PSH_WIZARD. Esistono alcune restrizioni sulla formattazione delle pagine. Ad esempio, non sono presenti bordi applicati e lo stile PSH_WIZARD_LITE non dipinge le bitmap di filigrana e intestazione per l'utente nel modo in cui viene eseguita la procedura guidata97. Questo flag non è supportato in combinazione con PSH_AEROWIZARD. |
hwndParent
Tipo: HWND
Gestire la finestra del proprietario del foglio delle proprietà.
hInstance
Tipo: HINSTANCE
Gestire l'istanza da cui caricare l'icona, la risorsa stringa titolo, il nome della pagina iniziale, la bitmap dell'intestazione o la filigrana. Se il membro pszIcon, pszCaption, pStartPage, pszbmHeader o pszbmWatermark identifica una risorsa da caricare, questo membro deve essere specificato.
hIcon
Tipo: HICON
Gestire l'icona da usare come icona piccola nella barra del titolo della finestra di dialogo del foglio delle proprietà. Questo membro viene usato se il membro dwFlags include PSH_USEHICON. Questo membro viene dichiarato come unione con pszIcon.
pszIcon
Tipo: LPCTSTR
Risorsa icona da usare come icona piccola nella barra del titolo della finestra di dialogo del foglio delle proprietà. Questo membro viene usato se il membro dwFlags include PSH_USEICONID. Questo membro può specificare l'identificatore della risorsa icona o l'indirizzo della stringa che specifica il nome della risorsa icona. In entrambi i casi, l'icona viene caricata dall'istanza fornita dal membro hInstance . Questo membro viene dichiarato come unione con hIcon.
pszCaption
Tipo: LPCTSTR
Titolo della finestra di dialogo del foglio delle proprietà. Questo membro può specificare l'identificatore di una risorsa stringa (caricata dall'istanza specificata dal membro hInstance ) o l'indirizzo di una stringa che specifica il titolo. Se il membro dwFlags include PSH_PROPTITLE, la stringa Proprietà per viene inserita all'inizio del titolo. Questo campo viene ignorato per le procedure guidate wizard97. Per le procedure guidate Aero, la stringa viene usata solo per la didascalia, indipendentemente dal fatto che il flag di PSH_PROPTITLE sia impostato.
nPages
Tipo: UINT
Numero di pagine del foglio delle proprietà fornite nella matrice ppsp o phpage .
nStartPage
Tipo: UINT
Indice in base zero della pagina iniziale visualizzata quando viene creata la finestra di dialogo del foglio delle proprietà. Questo membro viene usato se il membro dwFlags non include il flag di PSH_USEPSTARTPAGE. Questo membro viene dichiarato come unione con pStartPage.
pStartPage
Tipo: LPCTSTR
Nome della pagina iniziale visualizzata quando viene creata la finestra di dialogo del foglio delle proprietà. Questo membro viene usato se il membro dwFlags include il flag di PSH_USESTARTPAGE. Questo membro può specificare l'identificatore di una risorsa stringa (caricata dall'istanza specificata dal membro hInstance ) o l'indirizzo di una stringa che specifica il nome. Il nome della pagina iniziale viene corrispondente alle didascalie delle pagine. Questo membro viene dichiarato come unione con nStartPage.
ppsp
Tipo: LPCPROPSHEETPAGE
Puntatore a una matrice di strutture PROPSHEETPAGE che definiscono le pagine nel foglio delle proprietà. Se il membro dwFlags non include PSH_PROPSHEETPAGE, questo membro viene ignorato. Si noti che la struttura PROPSHEETPAGE è variabile in dimensioni. Le applicazioni che analizzano la matrice puntata da ppsp devono prendere in considerazione le dimensioni di ogni pagina. Questo membro viene dichiarato come unione con phpage.
phpage
Tipo: HPROPSHEETPAGE*
Puntatore a una matrice di handle nelle pagine del foglio delle proprietà. Questo membro viene usato se il membro dwFlags non include PSH_PROPSHEETPAGE. Ogni handle deve essere stato creato da una chiamata precedente alla funzione CreatePropertySheetPage . Quando la funzione PropertySheet restituisce, eventuali handle HPROPSHEETPAGE nella matrice phpage saranno stati eliminati. Questo membro viene dichiarato come unione con ppsp.
pfnCallback
Tipo: PFNPROPSHEETCALLBACK
Puntatore a una funzione di callback definita dall'applicazione chiamata quando si verificano determinati eventi. Per altre informazioni sulla funzione di callback, vedere la descrizione della funzione di callback PFNPROPSHEETCALLBACK . Se il membro dwFlags non include PSH_USECALLBACK, questo membro viene ignorato.
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.
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.
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.
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.
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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | Prsht.h |
| Nomi Unicode e ANSI | PROPSHEETHEADERW (Unicode) e PROPSHEETHEADERA (ANSI) |