PagePaintHook

O procedimento de gancho de PagePaintHook é um função callback application-defined ou library-defined usado com o PageSetupDlg função. Essa função recebe mensagens que permitem que você personalize o desenho da página de amostra na caixa de diálogo Configurar página.

O LPPAGEPAINTHOOK tipo define um ponteiro para este função callback. PagePaintHook é um espaço reservado para o nome função application-defined ou library-defined.

(UINT PagePaintHook de retorno de chamada HWND  hdlg, / / identificador para a janela de caixa de diálogoUINTpasta uiMsg, / / mensagem identificadorWPARAMwParam, / / parâmetro da mensagemLPARAMlParam / / parâmetro da mensagem);
 

Parâmetros

hdlg
Identificador para a janela de caixa de diálogo Configurar página.
pasta uiMsg
Identifica a mensagem sendo recebida.
wParam
Especifica informações adicionais sobre a mensagem. O significado exato depende do valor da pasta uiMsg parâmetro.
lParam
Especifica informações adicionais sobre a mensagem. O significado exato depende do valor da pasta uiMsg parâmetro.

Retornar valores

Se o procedimento gancho retorna TRUE para qualquer uma das três primeiras mensagens de uma seqüência de desenho (WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT ou WM_PSD_MINMARGINRECT), a caixa de diálogo envia mensagens não mais e não desenha na página de amostra até a próxima vez que o sistema precisa para redesenhar a página de exemplo. Se o procedimento gancho retorna FALSE para todas as três mensagens, a caixa de diálogo envia as mensagens remanescentes da seqüência desenho.

Se o procedimento gancho retorna TRUE para qualquer uma das mensagens restantes em uma seqüência de desenho, na caixa de diálogo não desenha a parte correspondente da página de amostra. Se o procedimento gancho retorna FALSE para qualquer uma dessas mensagens, a caixa de diálogo chama essa parte da página de amostra.

Observações

A caixa de diálogo Configurar página inclui uma imagem de uma página de amostra 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 do envelope selecionado, com um linha pontilhada Retangular que representa o atuais margens e parcial (texto grego) caracteres para mostrar a aparência do texto na página impressa. Quando você usa o PageSetupDlg função para criar uma caixa de diálogo Configurar página , você pode fornecer um procedimento de gancho de PagePaintHook para personalizar a aparência da página de amostra.

Para habilitar o procedimento gancho, use a PAGESETUPDLG estrutura que é passado para a função de criação diálogo. Especifica o ponteiro para o procedimento gancho in a lpfnPagePaintHook membro e especificar o sinalizador PSD_ENABLEPAGEPAINTHOOK in o sinalizadores membro.

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

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

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declaradas no commdlg.h.
Biblioteca de importação:Definido pelo usuário.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comuns, PageSetupDlg, PAGESETUPDLG

Index