Função EnumMetaFile (wingdi.h)

Artigo
03/04/2024

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