Função PlayMetaFile (wingdi.h)

  • Artigo

A função PlayMetaFile exibe a imagem armazenada no metafile de formato windows especificado no dispositivo especificado.

Nota Essa função é fornecida apenas para compatibilidade com metafiles no formato Windows. Os meta-arquivos de formato aprimorado fornecem funcionalidade superior e são recomendados para novos aplicativos. A função correspondente para um metarquivo de formato aprimorado é PlayEnhMetaFile.
 

Sintaxe

BOOL PlayMetaFile(
  [in] HDC       hdc,
  [in] HMETAFILE hmf
);

Parâmetros

[in] hdc

Identificador para um contexto de dispositivo.

[in] hmf

Manipule para um metarquivo no formato windows.

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

Para converter um metarquivo de formato windows em um metarquivo de formato aprimorado, use a função SetWinMetaFileBits .

Um metarquivo no formato windows pode ser reproduzido várias vezes.

Um metarquivo no formato Windows pode ser inserido em um segundo metarquivo no formato Windows chamando a função PlayMetaFile e reproduzindo o meta-arquivo de origem no contexto do dispositivo para o meta-arquivo de destino.

Qualquer objeto criado, mas não excluído no metarquivo no formato Windows, é 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.

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

Confira também

CancelDC

Funções de metafile

Visão geral dos metafiles

SetWinMetaFileBits