Condividi tramite

Struttura PSPINFO (compstui.h)

  • Articolo

La struttura PSPINFO viene utilizzata come parametro di input per la procedura della finestra di dialogo della pagina delle proprietà, quando il messaggio di Windows è WM_INITDIALOG. L'indirizzo della routine della finestra di dialogo viene specificato in una struttura DLGPAGE.

Sintassi

typedef struct _PSPINFO {
  WORD            cbSize;
  WORD            wReserved;
  HANDLE          hComPropSheet;
  HANDLE          hCPSUIPage;
  PFNCOMPROPSHEET pfnComPropSheet;
} PSPINFO, *PPSPINFO;

Membri

cbSize

Dimensioni fornite da CPSUI, in byte, della struttura PSPINFO.

wReserved

Riservato.

hComPropSheet

Handle fornito da CPSUI all'elemento padre della pagina il cui handle è contenuto in hCPSUIPage.

hCPSUIPage

Handle fornito da CPSUI nella pagina della finestra delle proprietà.

pfnComPropSheet

Puntatore fornito da CPSUI alla relativa funzione ComPropSheet.

Osservazioni

Prima che CPSUI chiami CreatePropertySheetPage per creare una pagina della finestra delle proprietà, espande le dimensioni della strutturaPROPSHEETPAGE standard per aggiungere una struttura PSPINFO. Quando il sistema operativo chiama una routine della finestra di dialogo (a cui punta una strutturaDLGPAGE) e specifica un messaggio di WM_INITDIALOG, il membro lParam punta alla struttura PROPSHEETPAGE espansa contenente la struttura PSPINFO.

Per ottenere l'indirizzo della struttura PSPINFO, utilizzare la macro PPSPINFO_FROM_WM_INITDIALOG_LPARAM (definita in compstui.h) come indicato di seguito:

PPSPINFO pPspInfo;
if (Msg == WM_INITDIALOG) {
    pPspInfo = PPSPINFO_FROM_WM_INITDIALOG_LPARAM(lParam);
}

Il puntatore alla struttura PSPINFO può essere salvato per un uso successivo, ma il contenuto della struttura non deve essere modificato.

Fabbisogno

Requisito Valore
intestazione compstui.h (include Compstui.h)