playMetaFile 函数 (wingdi.h)

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

注意 提供此函数只是为了与 Windows 格式图元文件的兼容性。 增强格式图元文件提供卓越的功能,建议用于新应用程序。 增强格式图元文件的相应函数为 PlayEnhMetaFile
 

语法

BOOL PlayMetaFile(
  [in] HDC       hdc,
  [in] HMETAFILE hmf
);

参数

[in] hdc

设备上下文的句柄。

[in] hmf

Windows 格式图元文件的句柄。

返回值

如果该函数成功,则返回值为非零值。

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

注解

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

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

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

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

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

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

CancelDC

图元文件函数

图元文件概述

SetWinMetaFileBits