Struttura PROPSHEETPAGE

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.

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 .

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.

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