Share via

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

  • Artigo

Especifica uma função de retorno de chamada definida pelo aplicativo que uma folha de propriedades chama quando uma página é criada e quando 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

Reservados; deve ser NULL.

[in] uMsg

Tipo: UINT

Sinalizador de ação. Esse parâmetro pode usar 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 obter mais discussões.

Retornar valor

Tipo: UINT

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

Comentários

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 .

Nota A folha de propriedades está no processo de manipular a lista de páginas quando essa função é chamada. Não tente adicionar, remover ou inserir páginas durante o tratamento dessa 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.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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