Função de retorno de chamada LPPAGEPAINTHOOK (commdlg.h)

  • Artigo

Recebe mensagens que permitem personalizar o desenho da página de exemplo na caixa de diálogo Configuração de Página . O procedimento de gancho PagePaintHook é uma função de retorno de chamada definida pelo aplicativo ou definida pela biblioteca usada com a função PageSetupDlg .

O tipo LPPAGEPAINTHOOK define um ponteiro para essa função de retorno de chamada. PagePaintHook é um espaço reservado para o nome da função definida pelo aplicativo ou definida pela biblioteca.

Sintaxe

LPPAGEPAINTHOOK Lppagepainthook;

UINT_PTR Lppagepainthook(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parâmetros

unnamedParam1

Um identificador para a caixa de diálogo Configuração de Página .

unnamedParam2

O identificador da mensagem que está sendo recebida.

unnamedParam3

Informações adicionais sobre a mensagem. O significado exato depende do valor do parâmetro unnamedParam2 .

unnamedParam4

Informações adicionais sobre a mensagem. O significado exato depende do valor do parâmetro unnamedParam2 .

Retornar valor

Se o procedimento de gancho retornar TRUE para qualquer uma das três primeiras mensagens de uma sequência de desenho (WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT ou WM_PSD_MINMARGINRECT), a caixa de diálogo não enviará mais mensagens e não será desenhada na página de exemplo até a próxima vez que o sistema precisar redesenhar a página de exemplo. Se o procedimento de gancho retornar FALSE para todas as três mensagens, a caixa de diálogo enviará as mensagens restantes da sequência de desenho.

Se o procedimento de gancho retornar TRUE para qualquer uma das mensagens restantes em uma sequência de desenho, a caixa de diálogo não desenhará a parte correspondente da página de exemplo. Se o procedimento de gancho retornar FALSE para qualquer uma dessas mensagens, a caixa de diálogo desenhará essa parte da página de exemplo.

Comentários

A caixa de diálogo Configuração de Página inclui uma imagem de uma página de exemplo que mostra como as seleções do usuário afetam a aparência da saída impressa. A imagem consiste em um retângulo que representa o tipo de papel ou envelope selecionado, com um retângulo de linha pontilhada representando as margens atuais e caracteres parciais (texto grego) para mostrar a aparência do texto na página impressa. Ao usar a função PageSetupDlg para criar uma caixa de diálogo Configuração de Página , você pode fornecer um procedimento de gancho PagePaintHook para personalizar a aparência da página de exemplo.

Para habilitar o procedimento de gancho, use a estrutura PAGESETUPDLG que você passou para a função de criação. Especifique o ponteiro para o procedimento de gancho no membro lpfnPagePaintHook e especifique o sinalizador PSD_ENABLEPAGEPAINTHOOK no membro Flags .

Sempre que a caixa de diálogo está prestes a desenhar o conteúdo da página de exemplo, o procedimento de gancho recebe as seguintes mensagens na ordem em que elas estão listadas.

Mensagem Significado
WM_PSD_PAGESETUPDLG A caixa de diálogo está prestes a desenhar a página de exemplo. O procedimento de gancho pode usar essa mensagem para se preparar para desenhar o conteúdo da página de exemplo.
WM_PSD_FULLPAGERECT A caixa de diálogo está prestes a desenhar a página de exemplo. Esta mensagem especifica o retângulo delimitador da página de exemplo.
WM_PSD_MINMARGINRECT A caixa de diálogo está prestes a desenhar a página de exemplo. Esta mensagem especifica o retângulo de margem.
WM_PSD_MARGINRECT A caixa de diálogo está prestes a desenhar o retângulo de margem.
WM_PSD_GREEKTEXTRECT A caixa de diálogo está prestes a desenhar o texto grego dentro do retângulo de margem.
WM_PSD_ENVSTAMPRECT A caixa de diálogo está prestes a ser desenhada no retângulo envelope-stamp de uma página de exemplo de envelope. Esta mensagem é enviada somente para envelopes.
WM_PSD_YAFULLPAGERECT A caixa de diálogo está prestes a desenhar a parte do endereço de retorno de uma página de exemplo de envelope. Esta mensagem é enviada para envelopes e outros tamanhos de papel.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commdlg.h (inclua Windows.h)

Confira também

Biblioteca de caixas de diálogo comuns

Conceitual

PAGESETUPDLG

Pagesetupdlg

Referência