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

EnumMetaFile

Previous pageReturn to chapter overviewNext page

描述

 

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

 

注意此函数仅用于与Windows格式的图元文件兼容。增强格式的图元文件提供卓越的功能,并推荐用于新的应用程序。增强格式图元文件的相应功能是EnumEnhMetaFile.

 

C++ 语法

 

BOOL EnumMetaFile(

__in HDC hdc,

__in HMETAFILE hmf,

__in MFENUMPROC lpMetaFunc,

__in LPARAM lParam

);

 

PowerBASIC 语法

 

FUNCTION EnumMetaFile ( _

BYVAL hdc AS DWORD, _

BYREF hmf AS DWORD, _

BYVAL lpMetaFunc AS DWORD, _

BYREF lpRect AS RECT _

) AS LONG

 

参数

 

hdc

 

[in]处理设备环境。该句柄被传递给回调函数。

 

hmf

 

[in]处理Windows格式的图元文件。

 

lpMetaFunc

 

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

 

lParam

 

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

 

返回值

 

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

 

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

 

备注

 

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

 

您可以使用EnumMetaFile功能将一个Windows格式的元文件嵌入另一个。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)