PlayEnhMetaFile功能显示存储在指定的增强格式图元文件中的图片。
BOOL PlayEnhMetaFile(
| HDC 【HDC】, | //处理设备上下文 |
| HENHMETAFILE 【HEMF】, | //处理增强型图元文件 |
| CONST RECT *【LPRECT】 | //指向边界矩形的指针 |
| ); |
参数
【HDC】
标识出现图像的输出设备的设备上下文。
【HEMF】
识别增强的图元文件。
【LPRECT】
指向RECT结构，其中包含用于显示图片的边界矩形的坐标。坐标以逻辑单位指定。
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。要获取扩展错误信息，请调用GetLastError.
备注
当应用程序调用{??989796057}功能时，Windows将使用增强型图元文件头中的图片框将图片映射到【LPRECT】参数指向的矩形上。（在调用PlayEnhMetaFile之前，可以通过在输出设备中设置世界变换来剪切或旋转此图片。）沿矩形边缘的点包含在图片中。
可以通过在播放增强型图元文件之前在输出设备中定义裁剪区域来修剪增强图元文件图片。
如果增强型图元文件包含可选的调色板，则应用程序可以在调用PlayEnhMetaFile之前在输出设备上设置调色板来实现一致的颜色。要检索可选调色板，请使用GetEnhMetaFilePaletteEntries功能。
增强的图元文件可以通过调用PlayEnhMetaFile并将源增强图元文件播放到新的增强型图元文件的设备上下文中来嵌入到新创建的增强型图元文件中。
输出设备上下文的状态由该函数保留。在增强的图元文件中创建但未删除的对象将被该函数删除。
要停止此函数，应用程序可以从另一个线程调用CancelDC函数来终止操作。在这种情况下，函数返回FALSE。
Windows 95： PlayEnhMetaFile受Windows 95 GDI的限制。例如，Windows 95仅支持16位有符号坐标。对于包含32位值的记录，如果值不在-32,768到32,767的范围内，则Windows 95无法播放记录。
也可以看看
CancelDC, GetEnhMetaFileHeader, GetEnhMetaFilePaletteEntries, RECT, SetWorldTransform
