CDC::PlayMetaFile

项目
03/01/2013

播放指定的图元文件的内容在设备上下文。

BOOL PlayMetaFile(
   HMETAFILE hMF 
);
BOOL PlayMetaFile(
   HENHMETAFILE hEnhMetaFile,
   LPCRECT lpBounds 
);

参数

hMF
标识要使用的该图元文件。
hEnhMetaFile
一个增强型图元文件。
lpBounds
指向 RECT 结构或包含用于的边框坐标显示图片的 CRect 对象。坐标在逻辑单位指定。

返回值

非零，如果函数运行成功;否则为0。

备注

该图元文件来播放任意多次。

PlayMetaFile 的第二个版本显示在特定引发格式图元文件中存储的图片。当应用程序调用 PlayMetaFile时的第二个版本，Windows在引发图元文件标头使用画框映射在矩形上的图片指向由 lpBounds 参数。（此图片能在或旋转通过将世界变换在输出设备在调用 PlayMetaFile之前)沿矩形前边缘在图片点包括。引发图元文件图片可以通过定义在输出设备的剪辑区域剪辑在播放该增强型图元文件之前。

如果一个增强型图元文件包含一个选项调色板，应用程序可以通过将在输出设备的一个调色板实现一致的颜色在调用 PlayMetaFile的第二个版本之前。若要检索选项调色板，请使用 GetEnhMetaFilePaletteEntries Windows功能。一个增强型图元文件在新创建的增强型图元文件中嵌入通过调用 PlayMetaFile 的第二个版本和播放该源增强型图元文件添加到新的增强型图元文件的设备上下文。

输出设备上下文的状态此函数将保留。在该增强型图元文件后，但不删除的所有对象此函数将删除。若要停止此功能，应用程序可以调用另一个线程的 CancelDC Windows函数终止操作。在这种情况下，该函数返回零。