Função EnumEnhMetaFile (wingdi.h)

Artigo
08/27/2023

A função EnumEnhMetaFile enumera os registros em um metarquivo de formato aprimorado 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.

Sintaxe

BOOL EnumEnhMetaFile(
  [in] HDC           hdc,
  [in] HENHMETAFILE  hmf,
  [in] ENHMFENUMPROC proc,
  [in] LPVOID        param,
  [in] const RECT    *lpRect
);

Parâmetros

[in] hdc

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

[in] hmf

Um identificador para um metarquivo avançado.

[in] proc

Um ponteiro para a função de retorno de chamada fornecida pelo aplicativo. Para obter mais informações, consulte a função EnhMetaFileProc .

[in] param

Um ponteiro para dados opcionais de função de retorno de chamada.

[in] lpRect

Um ponteiro para uma estrutura RECT que especifica as coordenadas, em unidades lógicas, dos cantos superior esquerdo e inferior direito da imagem.

Valor retornado

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

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

Comentários

Os pontos ao longo da borda do retângulo apontado pelo parâmetro lpRect são incluídos na imagem. Se o parâmetro hdc for NULL, o sistema ignorará lpRect.

Se a função de retorno de chamada chamar a função PlayEnhMetaFileRecord , o hdc deverá identificar um contexto de dispositivo válido. O sistema usa o modo de transformação e mapeamento do contexto do dispositivo para transformar a imagem exibida pela função PlayEnhMetaFileRecord .

Você pode usar a função EnumEnhMetaFile para inserir um meta-arquivo avançado dentro de outro.

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