Struttura PROPSHEETPAGE

Articolo
06/13/2023

Definisce una pagina in un foglio delle proprietà.

Sintassi

typedef struct {
    DWORD      dwSize;
    DWORD      dwFlags;
    HINSTANCE  hInstance;
    union {
        LPCSTR                 pszTemplate;
        PROPSHEETPAGE_RESOURCE pResource;
    };
    union {
        HICON  hIcon;
        LPCSTR pszIcon;
    };
    LPCSTR          pszTitle;
    DLGPROC         pfnDlgProc;
    LPARAM          lParam;
    LPFNPSPCALLBACK pfnCallback;
    UINT            *pcRefParent;
    LPCTSTR         pszHeaderTitle;
    LPCTSTR         pszHeaderSubTitle;
    HANDLE          hActCtx;
    union 
    {
        HBITMAP     hbmHeader;
        LPCSTR      pszbmHeader;
    }
} PROPSHEETPAGE, *LPPROPSHEETPAGE;

Members

dwSize

Tipo: DWORD

Dimensioni, in byte, di questa struttura.

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
PSP_DEFAULT	Usa il significato predefinito per tutti i membri della struttura. Questo flag non è supportato quando si usa la procedura guidata di stile aero (PSH_AEROWIZARD).
PSP_DLGINDIRECT	Crea la pagina dal modello di finestra di dialogo in memoria a cui punta il membro pResource . La funzione PropertySheet presuppone che il modello in memoria non sia protetto da scrittura. Un modello di sola lettura causerà un'eccezione in alcune versioni di Windows.
PSP_HASHELP	Abilita il pulsante Della Guida del foglio delle proprietà quando la pagina è attiva. Questo flag non è supportato quando si usa la procedura guidata di stile aero (PSH_AEROWIZARD).
PSP_HIDEHEADER	Versione 5.80 e successiva. Determina che la finestra delle proprietà della procedura guidata nasconde l'area dell'intestazione quando la pagina è selezionata. Se è stata fornita una filigrana, verrà dipinta sul lato sinistro della pagina. Questo flag deve essere impostato per le pagine di benvenuto e di completamento e omesso per le pagine interne. Questo flag non è supportato quando si usa la procedura guidata di stile aero (PSH_AEROWIZARD).
PSP_PREMATURE	Versione 4.71 o successiva. Determina la creazione della pagina quando viene creato il foglio delle proprietà. Se questo flag non è specificato, la pagina non verrà creata finché non viene selezionata la prima volta. Questo flag non è supportato quando si usa la procedura guidata di stile aero (PSH_AEROWIZARD).
PSP_RTLREADING	Inverte la direzione in cui viene visualizzata pszTitle . Le finestre normali visualizzano tutto il testo, incluso pszTitle, a sinistra a destra (LTR). Per le lingue come ebraico o arabo che leggevano RTL (right-to-left), una finestra può essere mirrorata e tutto il testo verrà visualizzato RTL. Se PSP_RTLREADING è impostato, pszTitle leggerà invece RTL in una normale finestra padre e LTR in una finestra padre con mirroring.
PSP_USECALLBACK	Chiama la funzione specificata dal membro pfnCallback durante la creazione o l'eliminazione della pagina del foglio delle proprietà definita da questa struttura.
PSP_USEFUSIONCONTEXT	Versione 6.0 e successiva. Usare un contesto di attivazione. Per usare un contesto di attivazione, è necessario impostare questo flag e assegnare l'handle di contesto di attivazione a hActCtx. Vedere le osservazioni.
PSP_USEHEADERSUBTITLE	Versione 5.80 o successiva. Visualizza la stringa a cui punta il membro pszHeaderSubTitle come sottotitolo dell'area dell'intestazione di una pagina Wizard97. Per usare questo flag, è necessario impostare anche il flag di PSH_WIZARD97 nel membro dwFlags della struttura PROPSHEETHEADER associata. Il flag di PSP_USEHEADERSUBTITLE viene ignorato se PSP_HIDEHEADER è impostato. Nelle procedure guidate in stile aero il titolo viene visualizzato nella parte superiore dell'area client.
PSP_USEHEADERTITLE	Versione 5.80 o successiva. Visualizza la stringa a cui punta il membro pszHeaderTitle come titolo nell'intestazione di una pagina interna di Wizard97. È anche necessario impostare il flag di PSH_WIZARD97 nel membro dwFlags della struttura PROPSHEETHEADER associata. Il flag di PSP_USEHEADERTITLE viene ignorato se viene impostato PSP_HIDEHEADER. Questo flag non è supportato quando si usa la procedura guidata di stile aero (PSH_AEROWIZARD).
PSP_USEHICON	Usa hIcon come icona piccola nella scheda per la pagina. Questo flag non è supportato quando si usa la procedura guidata di stile aero (PSH_AEROWIZARD).
PSP_USEICONID	Usa pszIcon come nome della risorsa icona per caricare e usare come icona piccola nella scheda per la pagina. Questo flag non è supportato quando si usa la procedura guidata di stile aero (PSH_AEROWIZARD).
PSP_USEREFPARENT	Gestisce il conteggio dei riferimenti specificato dal membro pcRefParent per la durata della pagina del foglio delle proprietà creata da questa struttura.
PSP_USETITLE	Usa il membro pszTitle come titolo della finestra di dialogo del foglio delle proprietà anziché il titolo archiviato nel modello della finestra di dialogo. Questo flag non è supportato quando si usa la procedura guidata di stile aero (PSH_AEROWIZARD).

hInstance

Tipo: HINSTANCE

Gestire l'istanza da cui caricare un'icona o una risorsa stringa. Se il membro pszIcon, pszTitle, pszHeaderTitle o pszHeaderSubTitle identifica una risorsa da caricare, è necessario specificare hInstance.

pszTemplate

Tipo: LPCSTR

Modello di finestra di dialogo da usare per creare la pagina. Questo membro può specificare l'identificatore della risorsa del modello o l'indirizzo di una stringa che specifica il nome del modello. Se il flag PSP_DLGINDIRECT nel membro dwFlags è impostato, pszTemplate viene ignorato. Questo membro viene dichiarato come unione con pResource.

pResource

Tipo: LPCDLGTEMPLATE

Puntatore a un modello di finestra di dialogo in memoria. La funzione PropertySheet presuppone che il modello non sia protetto da scrittura. Un modello di sola lettura causerà un'eccezione in alcune versioni di Windows. Per usare questo membro, è necessario impostare il flag di PSP_DLGINDIRECT nel membro dwFlags . Questo membro viene dichiarato come unione con pszTemplate.

hIcon

Tipo: HICON

Gestire l'icona da usare come icona nella scheda della pagina. Se il membro dwFlags non include PSP_USEHICON, questo membro viene ignorato. Questo membro viene dichiarato come unione con pszIcon.

pszIcon

Tipo: LPCSTR

Risorsa icona da usare come icona nella scheda della pagina. Questo membro può specificare l'identificatore della risorsa icona o l'indirizzo della stringa che specifica il nome della risorsa icona. Per usare questo membro, è necessario impostare il flag di PSP_USEICONID nel membro dwFlags . Questo membro viene dichiarato come unione con hIcon.

pszTitle

Tipo: LPCSTR

Titolo della finestra di dialogo del foglio delle proprietà. Questo titolo esegue l'override del titolo specificato nel modello della finestra di dialogo. Questo membro può specificare l'identificatore di una risorsa stringa o l'indirizzo di una stringa che specifica il titolo. Per usare questo membro, è necessario impostare il flag di PSP_USETITLE nel membro dwFlags .

pfnDlgProc

Tipo: DLGPROC

Puntatore alla procedura della finestra di dialogo per la pagina. Poiché le pagine vengono create come finestre di dialogo senza modalità, la procedura della finestra di dialogo non deve chiamare la funzione EndDialog .

lParam

Tipo: LPARAM

Quando viene creata la pagina, viene passata una copia della struttura PROPSHEETPAGE della pagina alla procedura della finestra di dialogo con un messaggio di WM_INITDIALOG . Il membro lParam viene fornito per consentire di passare informazioni specifiche dell'applicazione alla procedura della finestra di dialogo. Non ha alcun effetto sulla pagina stessa.

pfnCallback

Tipo: LPFNPSPCALLBACK

Puntatore a una funzione di callback definita dall'applicazione chiamata quando viene creata la pagina e quando sta per essere distrutto. Per altre informazioni sulla funzione di callback, vedere Funzione di callback LPFNPSPCALLBACKA. Per usare questo membro, è necessario impostare il flag di PSP_USECALLBACK nel membro dwFlags .

pcRefParent

Tipo: UINT*

Puntatore al valore del conteggio dei riferimenti. Per usare questo membro, è necessario impostare il flag di PSP_USEREFPARENT nel membro dwFlags .

Nota

Quando viene creata una pagina del foglio delle proprietà, il valore a cui fa riferimento pcRefParent viene incrementato. Creare una pagina del foglio delle proprietà in modo implicito impostando il flag di PSH_PROPSHEETPAGE nel membro dwFlags di PROPSHEETHEADER e chiamando la funzione PropertySheet . È possibile farlo in modo esplicito usando la funzione CreatePropertySheetPage . Quando viene eliminata una pagina del foglio delle proprietà, il valore a cui punta il membro pcRefParent viene decrementato . Questa operazione viene eseguita automaticamente quando il foglio delle proprietà viene distrutto. È possibile eliminare in modo esplicito una pagina del foglio delle proprietà usando la funzione DestroyPropertySheetPage .

pszHeaderTitle

Tipo: LPCTSTR

Versione 5.80 o successiva. Titolo dell'area dell'intestazione. Per usare questo membro nella procedura guidata in stile Wizard97, è necessario eseguire anche le operazioni seguenti:

Impostare il flag di PSP_USEHEADERTITLE nel membro dwFlags .
Impostare il flag di PSH_WIZARD97 nel membro dwFlags della struttura PROPSHEETHEADER della pagina.
Assicurarsi che il flag di PSP_HIDEHEADER nel membro dwFlags non sia impostato.

pszHeaderSubTitle

Tipo: LPCTSTR

Versione 5.80 o successiva. Sottotitolo dell'area dell'intestazione. Per usare questo membro, è necessario eseguire le operazioni seguenti:

Impostare il flag di PSP_USEHEADERSUBTITLE nel membro dwFlags .
Impostare il flag di PSH_WIZARD97 nel membro dwFlags della struttura PROPSHEETHEADER della pagina.
Assicurarsi che il flag di PSP_HIDEHEADER nel membro dwFlags non sia impostato.

Nota

Questo membro viene ignorato quando si usa la procedura guidata di stile aero (PSH_AEROWIZARD)

hActCtx

Tipo: HANDLE

Versione 6.0 o successiva. Handle di contesto di attivazione. Impostare questo membro sull'handle restituito quando si crea il contesto di attivazione con CreateActCtx. Il sistema attiverà questo contesto prima di creare la finestra di dialogo. Non è necessario usare questo membro se si usa un manifesto globale.

hbmHeader

Tipo: HBITMAP

Questo membro viene dichiarato come unione con pszbmHeader.

pszbmHeader

Tipo: LPCSTR

Questo membro viene dichiarato come unione con hbmHeader.

Commenti

Comctl32.dll versione 6 e versioni successive non sono ridistribuibili. Per usare Comctl32.dll versione 6 o successiva, specificare il file .dll in un manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

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)

Condividi tramite

Struttura PROPSHEETPAGE

Sintassi

Members

Commenti

Requisiti

Commenti e suggerimenti

Risorse aggiuntive