Função PlayEnhMetaFile (wingdi.h)
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 |