Compartilhar via

Função GdiEndPageEMF (winppi.h)

  • Artigo

A função GdiEndPageEMF encerra as operações de reprodução do EMF para uma página física de um trabalho de impressão formatado em EMF.

Sintaxe

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

Parâmetros

SpoolFileHandle

Identificador de arquivo de spool fornecido pelo chamador, obtido por uma chamada anterior para GdiGetSpoolFileHandle.

dwOptimization

Sinalizadores fornecidos pelo chamador. O seguinte sinalizador é definido:

EMF_PP_COLOR_OPTIMIZATION

Habilitar a otimização de cores. Para obter mais informações, consulte Comentários.

Retornar valor

Se a operação for bem-sucedida, a função retornará TRUE. Caso contrário, a função retornará FALSE e um código de erro poderá ser obtido chamando GetLastError.

Comentários

A função GdiEndPageEMF é exportada por gdi32.dll para uso dentro da função PrintDocumentOnPrintProcessor de um processador de impressão.

A função GdiEndPageEMF encerra o processamento de uma página física e faz com que ela seja ejetada da impressora. Um processador de impressão deve chamar GdiEndPageEMF nos seguintes horários:

  • Depois que o número apropriado de páginas de documentos tiver sido colocado na página física, faça chamadas para GdiPlayPageEMF. Observe que GdiPlayPageEMF não é realmente impresso no contexto do dispositivo, mas prepara uma estrutura de dados que descreve o texto e os elementos gráficos que devem ser impressos nas páginas físicas. O texto e os gráficos são impressos no contexto do dispositivo quando GdiEndPageEMF é chamado.
  • Sempre que uma chamada para GdiGetDevmodeForPage indica que a estrutura DEVMODEW de uma página de documento é diferente da estrutura DEVMODE da página anterior.
Se essa função for chamada com o parâmetro dwOptimization definido como EMF_PP_COLOR_OPTIMIZATION, a otimização de cores será habilitada. Se dwOptimization estiver definido como 0, nenhuma otimização será executada. Quando a otimização de cores está habilitada, a presença de cor no arquivo de spool faz com que o arquivo de spool seja reproduzido em cores; a falta de cor no arquivo de spool faz com que o arquivo de spool seja reproduzido em monocromático.

Se você estiver criando um plug-in de renderização Unidrv para gerar marcas d'água coloridas, lembre-se de que a otimização de cores faz com que as marcas d'água coloridas sejam impressas em preto e branco quando são impressas em documentos em preto e branco. Para garantir que as marcas d'água coloridas imprimam corretamente com documentos de cor e preto e branco, desabilite a otimização de cores.

A otimização de cor controlada pelo parâmetro dwOptimization também pode ser controlada definindo o membro dwColorOptimization das estruturas ATTRIBUTE_INFO_2 ou ATTRIBUTE_INFO_3 . Essa otimização também pode ser controlada pelo atributo de cor Unidrv *ChangeColorModeOnDoc? (consulte Atributos de cor).

Para obter informações adicionais, consulte Usando funções GDI em processadores de impressão.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho winppi.h (inclua Winppi.h)
Biblioteca Gdi32.Lib
DLL Gdi32.dll

Confira também

GdiPlayPageEMF

GdiStartPageEMF