CDC::PlayMetaFile

BOOL PlayMetaFile(HMETAFILE hMF);
BOOL PlayMetaFile(HENHMETAFILE hEnhMetaFile,LPCRECTlpBounds);

返回值:如果成功,则返回非零值,否则为0。

参数:
hMF要播放的元文件。
hEnhMetaFile增强元文件的标识。
lpBoundsRECT结构或CRect对象的指针,它们包含用来显示图形的外接矩形坐标,坐标均用逻辑单位表示。

说明:
在设备上下文中播放指定的元文件内容,文件可播放任意次数。PlayMetaFile的第二种版本,可以显示用增强型元文件存储的图片。当应用调用PlayMetaFile的第二种版本时,Windows 使用增强元文件头标中的图片框架,使图片映射到lpBounds所指向的矩形之中(在调用PlayMetaFile之前,该图片可以被选择或剪切),图片包括矩形边界上的点。在播放增强格式元文件之前在输出设备上定义剪切区,可以剪切增强格式元文件。如果增强元文件中包含一个可选用的调色板,这样,在调用PlayMetaFile第二种版本之前,在输出设备上设置调色板,应用便可获得连续色。使用::PlayEnhMetaFile函数可以获得调色板。通过调用PlayMetaFile第二种版本并播放源增强元文件到设备上下文中,可使增强元文件嵌入新创建的增强元文件中。函数保存了输出设备上下文的状态,所有由增强元文件产生但不能由其删除的对象,可以由该函数完成。为停止该函数,应用可以从另一线程中调用::CancelDC函数来中止操作,此情况下,函数返回0。

请参阅:
::CancelDC, ::GetEnhMetaFileHeader, ::GetEnhMetaFilePaletteEntries, ::SetWorldTransform, ::PlayEnhMetaFile, ::PlayMetaFile