Função PlayEnhMetaFile (wingdi.h)

Artigo
08/27/2023

A função PlayEnhMetaFile exibe a imagem armazenada no metarquivo de formato aprimorado especificado.

Sintaxe

BOOL PlayEnhMetaFile(
  [in] HDC          hdc,
  [in] HENHMETAFILE hmf,
  [in] const RECT   *lprect
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo para o dispositivo de saída no qual a imagem será exibida.

[in] hmf

Um identificador para o metarquivo aprimorado.

[in] lprect

Um ponteiro para uma estrutura RECT que contém as coordenadas do retângulo delimitador usado para exibir a imagem. As coordenadas são especificadas em unidades lógicas.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Quando um aplicativo chama a função PlayEnhMetaFile , o sistema usa o quadro de imagem no cabeçalho enhanced-metafile para mapear a imagem para o retângulo apontado pelo parâmetro lpRect . (Essa imagem pode ser disparada ou girada definindo a transformação do mundo no dispositivo de saída antes de chamar PlayEnhMetaFile.) Os pontos ao longo das bordas do retângulo são incluídos na imagem.

Uma imagem de meta-arquivo aprimorada pode ser recortada definindo a área de recorte no dispositivo de saída antes de reproduzir o meta-arquivo aprimorado.

Se um meta-arquivo aprimorado contiver uma paleta opcional, um aplicativo poderá obter cores consistentes configurando uma paleta de cores no dispositivo de saída antes de chamar PlayEnhMetaFile. Para recuperar a paleta opcional, use a função GetEnhMetaFilePaletteEntries .

Um meta-arquivo aprimorado pode ser inserido em um meta-arquivo aprimorado recém-criado chamando PlayEnhMetaFile e reproduzindo o meta-arquivo aprimorado de origem no contexto do dispositivo para o novo meta-arquivo aprimorado.

Os estados do contexto de dispositivo de saída são preservados por essa função. Qualquer objeto criado, mas não excluído no meta-arquivo aprimorado, é excluído por essa função.

Para interromper essa função, um aplicativo pode chamar a função CancelDC de outro thread para encerrar a operação. Nesse caso, a função retorna FALSE.

Exemplos

Para obter um exemplo, consulte Abrindo um metarquivo avançado e exibindo seu conteúdo.

Requisitos


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	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll