PlayEnhMetaFile 函数 (wingdi.h)

PlayEnhMetaFile 函数显示存储在指定增强格式图元文件中的图片。

语法

BOOL PlayEnhMetaFile(
  [in] HDC          hdc,
  [in] HENHMETAFILE hmf,
  [in] const RECT   *lprect
);

[in] hdc

显示图片的输出设备的设备上下文的句柄。

[in] hmf

增强型图元文件的句柄。

[in] lprect

指向 RECT 结构的指针，该结构包含用于显示图片的边框的坐标。坐标以逻辑单元指定。

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

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

当应用程序调用 PlayEnhMetaFile 函数时，系统使用增强型图元文件标头中的图片框将图片映射到 lpRect 参数指向的矩形上。 (在调用 PlayEnhMetaFile 之前，可以通过在输出设备中设置世界变换来剪切或旋转此图片。图片中包括矩形边缘的 ) 点。

可以通过在播放增强型图元文件之前在输出设备中定义剪切区域来剪裁增强型图元文件图片。

如果增强型图元文件包含可选调色板，则应用程序可以通过在调用 PlayEnhMetaFile 之前在输出设备上设置调色板来实现一致的颜色。若要检索可选调色板，请使用 GetEnhMetaFilePaletteEntries 函数。

通过调用 PlayEnhMetaFile 并将源增强型图元文件播放到新增强型图元文件的设备上下文中，可以将增强型图元文件嵌入到新创建的增强型图元文件中。

此函数保留输出设备上下文的状态。在增强型图元文件中创建但未删除的任何对象都被此函数删除。

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


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