• 文档 /
  • EnumEnhMetaFile-通过检索每个记录并将其传递给指定的回调函数来枚举增强格式的图元文件中的记录

平台 SDK: Windows GDI

EnumEnhMetaFile

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

BOOL EnumEnhMetaFile(
  HDC hdc,                     // 设备上下文句柄
  HENHMETAFILE hemf,           // 增强图元文件句柄
  ENHMFENUMPROC lpEnhMetaFunc, // 回调函数
  LPVOID lpData,               // 回调函数数据
  CONST RECT *lpRect           // 边界矩形
);

参数

  • hdc

  • [in] 设备上下文句柄。 该句柄被传递给回调函数。

  • hemf

  • [in] 增强图元文件句柄。

  • lpEnhMetaFunc

  • [in] 指向应用程序提供的回调函数。 有关更多信息,请参阅EnhMetaFileProc函数。

  • lpData

  • [in] 指向可选的回调函数数据。

  • lpRect

  • [in] 指向RECT结构的指针,指定图片左上角和右下角的坐标(以逻辑为单位)。

返回值


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

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

备注


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

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

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

要求

   Windows NT / 2000 / XP:包含在Windows NT 3.1及更高版本中。

   Windows 95/98 / Me:包含在Windows 95及更高版本中。

   头文件:声明于Wingdi.h; 包含于Windows.h。

   库:使用Gdi32.lib