Compartilhar via

Estrutura PSPINFO (compstui.h)

  • Artigo

A estrutura de PSPINFO é usada como um parâmetro de entrada para o procedimento de 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 de 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 de 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 de comPropSheet.

Observações

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