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