enumMetaFile 函数 (wingdi.h)

EnumMetaFile 函数通过检索每个记录并将其传递到指定的回调函数来枚举 Windows 格式图元文件中的记录。 应用程序提供的回调函数根据需要处理每个记录。 枚举一直持续到处理最后一条记录或回调函数返回零时。

注意 提供此函数仅用于与 Windows 格式图元文件的兼容性。 增强格式的图元文件提供卓越的功能,建议用于新应用程序。 增强格式图元文件的相应函数为 EnumEnhMetaFile
 

语法

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

参数

[in] hdc

设备上下文的句柄。 此句柄将传递给回调函数。

[in] hmf

Windows 格式图元文件的句柄。

[in] proc

指向应用程序提供的回调函数的指针。 有关详细信息,请参阅 EnumMetaFileProc

[in] param

指向可选数据的指针。

返回值

如果回调函数成功枚举 Windows 格式图元文件中的所有记录,则返回值为非零值。

如果回调函数未成功枚举 Windows 格式图元文件中的所有记录,则返回值为零。

注解

若要将 Windows 格式的图元文件转换为增强格式的图元文件,请使用 SetWinMetaFileBits 函数。

可以使用 EnumMetaFile 函数将一个 Windows 格式的图元文件嵌入另一个中。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

EnumEnhMetaFile

EnumMetaFileProc

图元文件函数

图元文件概述

PlayMetaFile

PlayMetaFileRecord

SetWinMetaFileBits