Struttura PSPINFO (compstui.h)

La struttura PSPINFO viene usata come parametro di input per la finestra di dialogo della pagina delle proprietà, quando il messaggio di Windows viene 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;

Members

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 del foglio delle proprietà.

pfnComPropSheet

Puntatore fornito da CPSUI alla funzione ComPropSheet .

Commenti

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

Per ottenere l'indirizzo della struttura PSPINFO , usare 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 della struttura PSPINFO può essere salvato per un uso successivo, ma il contenuto della struttura non deve essere modificato.

Requisiti