enumEnhMetaFile 函数 (wingdi.h)

项目
08/27/2023

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

语法

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

参数

[in] hdc

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

[in] hmf

增强型图元文件的图柄。

[in] proc

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

[in] param

指向可选回调函数数据的指针。

[in] lpRect

指向 RECT 结构的指针，该结构指定图片左上角和右下角的坐标（以逻辑单位表示）。

返回值

如果回调函数成功枚举增强型图元文件中的所有记录，则返回值为非零值。

如果回调函数未成功枚举增强型图元文件中的所有记录，则返回值为零。

注解

图片中包含 lpRect 参数指向的矩形边缘的点。如果 hdc 参数为 NULL，则系统忽略 lpRect。

如果回调函数调用 PlayEnhMetaFileRecord 函数， 则 hdc 必须标识有效的设备上下文。系统使用设备上下文的转换和映射模式来转换 PlayEnhMetaFileRecord 函数显示的图片。

可以使用 EnumEnhMetaFile 函数将一个增强型图元文件嵌入另一个文件中。

要求


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