Função de retorno de chamada LPPAGEPAINTHOOK (commdlg.h)
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
Referência