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 |