Função GdiPlayPageEMF (winppi.h)

  • Artigo

A função GdiPlayPageEMF reproduz os registros EMF em um retângulo especificado para uma página de documento de um trabalho de impressão em spool.

Sintaxe

BOOL GdiPlayPageEMF(
  HANDLE SpoolFileHandle,
  HANDLE hemf,
  RECT   *prectDocument,
  RECT   *prectBorder,
  RECT   *prectClip
);

Parâmetros

SpoolFileHandle

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

hemf

Identificador de página fornecido pelo chamador, obtido chamando GdiGetPageHandle, identificando a página para a qual os registros devem ser reproduzidos.

prectDocument

Ponteiro fornecido pelo chamador para uma estrutura RECT especificando o retângulo no qual a página deve ser desenhada.

prectBorder

Ponteiro fornecido pelo chamador para uma estrutura RECT especificando o retângulo de borda da página (se houver). Pode ser NULL.

prectClip

Ponteiro fornecido pelo chamador para uma estrutura RECT especificando as coordenadas da região de clipe da página (se houver). Pode ser NULL.

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 GdiPlayPageEMF é exportada por gdi32.dll para uso dentro da função PrintDocumentOnPrintProcessor de um processador de impressão.

A função GdiPlayPageEMF é o meio pelo qual um processador de impressão posiciona uma página de documento ou uma região retangular especificada de uma página de documento em uma página física. 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.

O processador de impressão usa prectClip para descrever a região retangular a ser impressa e prectDocument para descrever um retângulo no qual a página do documento (ou região recortada) deve se ajustar. Se prectClip for NULL, a página inteira do documento será impressa. Para valores não NULL de prectClip, somente a parte da página do documento dentro da região de clipe será impressa. A função GdiPlayPageEMF executa as operações de dimensionamento e tradução necessárias para que a página do documento (ou parte selecionada) se ajuste ao retângulo.

O parâmetro prectBorder , se não for NULL, descreve um retângulo de borda de linha sólida a ser desenhado ao redor da página do documento. Se prectBorder for NULL, nenhuma borda será desenhada.

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

GdiEndPageEMF