Compartilhar via


Função EnumMetaFile (wingdi.h)

A função EnumMetaFile enumera os registros em um metarquivo no formato windows recuperando cada registro e passando-os para a função de retorno de chamada especificada. A função de retorno de chamada fornecida pelo aplicativo processa cada registro conforme necessário. A enumeração continua até que o último registro seja processado ou quando a função de retorno de chamada retornar zero.

Nota Essa função é fornecida apenas para compatibilidade com metarquivos 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 é EnumEnhMetaFile.
 

Sintaxe

BOOL EnumMetaFile(
  [in] HDC        hdc,
  [in] HMETAFILE  hmf,
  [in] MFENUMPROC proc,
  [in] LPARAM     param
);

Parâmetros

[in] hdc

Identificador para um contexto de dispositivo. Esse identificador é passado para a função de retorno de chamada.

[in] hmf

Manipule para um metarquivo no formato do Windows.

[in] proc

Ponteiro para uma função de retorno de chamada fornecida pelo aplicativo. Para obter mais informações, consulte EnumMetaFileProc.

[in] param

Ponteiro para dados opcionais.

Retornar valor

Se a função de retorno de chamada enumerar com êxito todos os registros no metarquivo no formato windows, o valor retornado será diferente de zero.

Se a função de retorno de chamada não enumerar com êxito todos os registros no metarquivo de formato do Windows, o valor retornado será zero.

Comentários

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

Você pode usar a função EnumMetaFile para inserir um metarquivo no formato do Windows dentro de outro.

Requisitos

Requisito Valor
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

EnumEnhMetaFile

EnumMetaFileProc

Funções de metarquivo

Visão geral de meta-arquivos

Playmetafile

PlayMetaFileRecord

SetWinMetaFileBits