Função de retorno de chamada PFNPROPSHEETUI (compstui.h)

O tipo de função PFNPROPSHEETUI é usado por aplicativos CPSUI (incluindo DLLs de interface da impressora) para definir retornos de chamada de criação de página, que especificam páginas de folha de propriedades para criação.

Sintaxe

PFNPROPSHEETUI Pfnpropsheetui;

LONG Pfnpropsheetui(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM lParam
)
{...}

Parâmetros

pPSUIInfo

Ponteiro fornecido por CPSUI para uma estrutura de PROPSHEETUI_INFO .

lParam

Valor inteiro fornecido por CPSUI que depende do conteúdo do membro Reason da estrutura PROPSHEETUI_INFO . Estes são os valores válidos:

PROPSHEETUI_REASON_BEFORE_INIT

Esse valor é novo para Windows 8 e é fornecido apenas para o parâmetro PFNPROPSHEETUI original passado para CommonPropertySheetUI.

PROPSHEETUI_REASON_DESTROY

O valor lParam não será zero se o usuário tiver selecionado o botão OK ou Cancelar da folha de propriedades. Caso contrário, o valor será zero.

PROPSHEETUI_REASON_GET_ICON

O valor lParam é um ponteiro para uma estrutura de PROPSHEETUI_GETICON_INFO .

PROPSHEETUI_REASON_GET_INFO_HEADER

O valor lParam é um ponteiro para uma estrutura de PROPSHEETUI_INFO_HEADER .

PROPSHEETUI_REASON_INIT

Se a função de retorno de chamada for especificada pelo parâmetro pfnPropSheetUI para CommonPropertySheetUI, lParam será o valor lParam passado para CommonPropertySheetUI.

Se a função de retorno de chamada for especificada usando o código de função CPSFUNC_ADD_PFNPROPSHEETUI com a função ComPropSheet do CPSUI, lParam será o valor lParam2 passado para ComPropSheet.

O CPSUI copia o valor lParam no membro lParamInit da estrutura PROPSHEETUI_INFO da função.

O valor lParam não deve residir na pilha do aplicativo.

PROPSHEETUI_REASON_SET_RESULT

O valor lParam é um ponteiro para uma estrutura SETRESULT_INFO .

Retornar valor

Se a operação for bem-sucedida, a função deverá retornar um valor igual a um (ou maior). Caso contrário, ele deverá retornar um valor menor que um.

Código de retorno	Descrição
Um ou mais.	A função PFNPROPSHEETUI associada ao pai da página atual será chamada.
Menos de 1.	A função PFNPROPSHEETUI associada ao pai da página atual não será chamada.

Comentários

As funções de retorno de chamada especificadas usando o tipo de função PFNPROPSHEETUI são fornecidas por aplicativos que usam CPSUI para gerenciar páginas de folha de propriedades personalizadas. Uma dessas funções de retorno de chamada deve ser especificada quando um aplicativo chama a função CommonPropertySheetUI . Por exemplo, quando o spooler de impressão do sistema operacional baseado em NT chama a função CommonPropertySheetUI da CPSUI para dar suporte às funções DocumentProperties ou PrinterProperties , o spooler especifica uma função de retorno de chamada interna do tipo PFNPROPSHEETUI.

Os aplicativos podem especificar funções adicionais de retorno de chamada do tipo PFNPROPSHEETUI chamando a função ComPropSheet do CPSUI com um código de função de CPSFUNC_ADD_PFNPROPSHEETUI. Por exemplo, o spooler de impressão do sistema operacional baseado em NT faz isso para notificar o CPSUI sobre a existência de uma interface de impressora das funções DrvDocumentPropertySheets e DrvDevicePropertySheets da interface da impressora. Da mesma forma, os drivers Unidrv e Pscript da Microsoft usam essa técnica para notificar o CPSUI sobre a existência dos métodos IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets nos plug-ins da interface do usuário.

Cada função de retorno de chamada do tipo PFNPROPSHEETUI é chamada pelo CPSUI várias vezes. O membro Reason da estrutura PROPSHEETUI_INFO estipula a operação que a função deve executar, da seguinte maneira:

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	compstui.h (inclua Compstui.h)