勇芳软件工作室.汉化:  Metafiles > Metafile Functions >

EnumEnhMetaFile

Previous pageReturn to chapter overviewNext page

描述

 

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

 

C++ 语法

 

BOOL EnumEnhMetaFile(

__in HDC hdc,

__in HENHMETAFILE hemf,

__in ENHMFENUMPROC lpEnhMetaFunc,

__in LPVOID lpData,

__in const RECT *lpRect

);

 

PowerBASIC 语法

 

FUNCTION EnumEnhMetaFile ( _

BYVAL hdc AS DWORD, _

BYREF hemf AS DWORD, _

BYVAL lpEnhMetaFunc AS DWORD, _

BYREF lpData AS ANY, _

BYREF lpRect AS RECT _

) AS LONG

 

参数

 

hdc

 

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

 

hemf

 

[in]处理增强型图元文件。

 

lpEnhMetaFunc

 

[in]指向应用程序提供的回调函数的指针。有关详细信息,请参阅EnhMetaFileProc功能。

 

lpData

 

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

 

lpRect

 

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

 

返回值

 

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

 

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

 

备注

 

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

 

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

 

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

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)