Estrutura PSPINFO (compstui.h)

A estrutura PSPINFO é usada como um parâmetro de entrada para o procedimento da caixa de diálogo de uma página de folha de propriedades, quando a mensagem do Windows é WM_INITDIALOG. O endereço do procedimento da caixa de diálogo é especificado em uma estrutura DLGPAGE .

Sintaxe

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

Membros

cbSize

Tamanho fornecido por CPSUI, em bytes, da estrutura PSPINFO .

wReserved

Reservado.

hComPropSheet

Identificador fornecido por CPSUI para o pai da página cujo identificador está contido em hCPSUIPage.

hCPSUIPage

Identificador fornecido por CPSUI para a página da folha de propriedades.

pfnComPropSheet

Ponteiro fornecido por CPSUI para sua função ComPropSheet .

Comentários

Antes que o CPSUI chame CreatePropertySheetPage para criar uma página de folha de propriedades, ele expande o tamanho da estrutura PROPSHEETPAGE padrão para acrescentar uma estrutura PSPINFO . Quando o sistema operacional chama um procedimento de caixa de diálogo (apontado por uma estrutura DLGPAGE ) e especifica uma mensagem WM_INITDIALOG , o membro lParam da função aponta para a estrutura PROPSHEETPAGE expandida que contém a estrutura PSPINFO .

Para obter o endereço da estrutura PSPINFO , use a macro PPSPINFO_FROM_WM_INITDIALOG_LPARAM (definida em compstui.h) da seguinte maneira:

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

O ponteiro da estrutura PSPINFO pode ser salvo para uso posterior, mas o conteúdo da estrutura não deve ser modificado.

Requisitos

Requisito	Valor
Cabeçalho	compstui.h (inclua Compstui.h)