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