Função de retorno de chamada LPFNPSPCALLBACKA (prsht.h)

Artigo
11/20/2024

Especifica uma função de retorno de chamada definida pelo aplicativo que uma folha de propriedades chama quando uma página é criada e quando ela está prestes a ser destruída. Um aplicativo pode usar essa função para executar operações de inicialização e limpeza para a página.

Sintaxe

LPFNPSPCALLBACKA Lpfnpspcallbacka;

UINT Lpfnpspcallbacka(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEA *ppsp
)
{...}

Parâmetros

hwnd

Tipo: HWND

Reservado; deve ser NULL.

[in] uMsg

Tipo: UINT

Sinalizador de ação. Esse parâmetro pode ser um dos valores a seguir.

Valor	Significado
PSPCB_ADDREF	versão 5.80 ou posterior. Uma página está sendo criada. O valor retornado não é usado.
PSPCB_CREATE	Uma caixa de diálogo para uma página está sendo criada. Retorne diferente de zero para permitir que ele seja criado ou zero para impedi-lo.
PSPCB_RELEASE	Uma página está sendo destruída. O valor retornado é ignorado.

[in, out] ppsp

Tipo: LPPROPSHEETPAGE

Ponteiro para uma estrutura PROPSHEETPAGE que define a página que está sendo criada ou destruída. Consulte a seção Comentários para mais discussões.

Valor de retorno

Tipo: UINT

O valor retornado depende do valor do parâmetro uMsg.

Observações

Um aplicativo deve especificar o endereço dessa função de retorno de chamada no membro pfnCallback de uma estrutura PROPSHEETPAGE antes de passar a estrutura para a função CreatePropertySheetPage .

Observação A folha de propriedades está em processo de manipulação da lista de páginas quando essa função é chamada. Não tente adicionar, remover ou inserir páginas durante o tratamento desta notificação. Isso terá resultados imprevisíveis.

Com exceção do membro lParam, seu aplicativo não deve modificar a estrutura PROPSHEETPAGE . Isso terá resultados imprevisíveis. O membro lParam contém dados definidos pelo aplicativo e pode ser modificado conforme necessário.

Nota

O cabeçalho prsht.h define LPFNPSPCALLBACK como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	prsht.h

Compartilhar via