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

PlayMetaFileRecord

Previous pageReturn to chapter overviewNext page

描述

 

通过执行该记录中包含的图形设备接口(GDI)功能,PlayMetaFileRecord功能播放Windows格式的图元文件记录。

 

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

 

C++ 语法

 

BOOL PlayMetaFileRecord(

__in HDC hdc,

__in LPHANDLETABLE lpHandletable,

__in LPMETARECORD lpMetaRecord,

__in UINT nHandles

);

 

PowerBASIC 语法

 

FUNCTION PlayMetaFileRecord ( _

BYVAL hdc AS DWORD, _

BYREF lpHandletable AS HANDLETABLE, _

BYREF lpMetaRecord AS METARECORD, _

BYVAL nHandles AS DWORD _

) AS LONG

 

参数

 

hdc

 

[in]处理设备环境。

 

lpHandletable

 

[in]指向HANDLETABLE结构的指针,表示播放元文件时使用的GDI对象的句柄表。

 

lpMetaRecord

 

[in]指向Windows格式的图元文件记录。

 

nHandles

 

[in]指定句柄表中的句柄数。

 

返回值

 

如果函数成功,返回值不为零。

 

如果函数失败,返回值为零。

 

备注

 

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

 

应用程序通常使用PlayMetaFileRecordEnumMetaFile功能一起处理和播放Windows格式的元文件一个记录。

 

这里ndletablenHandles参数必须与EnumMetaFile传递给EnumMetaFileProc回调过程的参数相同。

 

如果PlayMetaFileRecord功能无法识别记录,则会忽略该记录并返回TRUE。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)