Estructura PSPINFO (compstui.h)

La estructura PSPINFO se usa como parámetro de entrada para el procedimiento del cuadro de diálogo de una página de hojas de propiedades, cuando el mensaje de Windows se WM_INITDIALOG. La dirección del procedimiento del cuadro de diálogo se especifica en una estructura DLGPAGE .

Sintaxis

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

Miembros

cbSize

Tamaño proporcionado por CPSUI, en bytes, de la estructura PSPINFO .

wReserved

Reservado.

hComPropSheet

Identificador proporcionado por CPSUI al elemento primario de la página cuyo identificador se encuentra en hCPSUIPage.

hCPSUIPage

Identificador proporcionado por CPSUI a la página de la hoja de propiedades.

pfnComPropSheet

Puntero proporcionado por CPSUI a su función ComPropSheet .

Comentarios

Antes de que CPSUI llame a CreatePropertySheetPage para crear una página de hoja de propiedades, expande el tamaño de la estructura PROPSHEETPAGE estándar para anexar una estructura PSPINFO . Cuando el sistema operativo llama a un procedimiento de cuadro de diálogo (al que apunta una estructura DLGPAGE ) y especifica un mensaje de WM_INITDIALOG , el miembro lParam de la función apunta a la estructura PROPSHEETPAGE expandida que contiene la estructura PSPINFO .

Para obtener la dirección de la estructura PSPINFO , use la macro PPSPINFO_FROM_WM_INITDIALOG_LPARAM (definida en compstui.h) de la siguiente manera:

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

El puntero de estructura PSPINFO se puede guardar para su uso posterior, pero el contenido de la estructura no debe modificarse.

Requisitos

Requisito	Valor
Header	compstui.h (incluir Compstui.h)