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

PlayMetaFile

Previous pageReturn to chapter overviewNext page

描述

 

PlayMetaFile功能显示存储在指定设备上的给定Windows格式元文件中的图片。

 

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

 

C++ 语法

 

BOOL PlayMetaFile(

__in HDC hdc,

__in HMETAFILE hmf

);

 

PowerBASIC 语法

 

FUNCTION PlayMetaFile ( _

BYVAL hdc AS DWORD, _

BYREF hmf AS DWORD _

) AS LONG

 

参数

 

hdc

 

[in]处理设备上下文。

 

hmf

 

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

 

返回值

 

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

 

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

 

备注

 

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

 

Windows格式的图元文件可以多次播放。

 

可以通过调用PlayMetaFile函数并将源元文件播放到目标元文件的设备上下文中,将Windows格式的图元文件嵌入到第二个Windows格式的图元文件中。

 

在Windows格式的图元文件中创建但未删除的任何对象都将被该函数删除。

 

要停止此函数,应用程序可以从另一个线程调用CancelDC函数来终止操作。在这种情况下,函数返回FALSE。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)