描述
PlayEnhMetaFile功能显示存储在指定的增强格式图元文件中的图片。
C++ 语法
BOOL PlayEnhMetaFile( __in HDC hdc, __in HENHMETAFILE hemf, __in const RECT *lpRect ); |
PowerBASIC 语法
FUNCTION PlayEnhMetaFile ( _ BYVAL hdc AS DWORD, _ BYREF hemf AS DWORD, _ BYREF lpRect AS RECT _ ) AS LONG |
参数
hdc
[in]处理图像出现的输出设备的设备上下文。
hemf
[in]处理增强型图元文件。
lpRect
[in]指向RECT结构的指针，其中包含用于显示图片的边界矩形的坐标。坐标以逻辑单位指定。
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。
备注
当应用程序调用{??989796085}功能时，系统将使用增强型图元文件头中的图片框将图片映射到LPRECT参数指向的矩形上。（在调用PlayEnhMetaFile之前，可以通过在输出设备中设置世界变换来剪切或旋转此图片。）沿矩形边缘的点包含在图片中。
可以通过在播放增强型图元文件之前在输出设备中定义裁剪区域来修剪增强图元文件图片。
如果增强型图元文件包含可选的调色板，则应用程序可以在调用PlayEnhMetaFile之前在输出设备上设置调色板来实现一致的颜色。要检索可选调色板，请使用GetEnhMetaFilePaletteEntries功能。
增强的图元文件可以通过调用PlayEnhMetaFile并将源增强图元文件播放到新的增强型图元文件的设备上下文中来嵌入新创建的增强型图元文件中。
输出设备上下文的状态由该函数保留。在增强的图元文件中创建但未删除的对象将被该函数删除。
要停止此函数，应用程序可以从另一个线程调用CancelDC函数来终止操作。在这种情况下，函数返回FALSE。
Windows 95/98 / Me：PlayEnhMetaFile受GDI的限制。例如，Windows 95/98 / Me仅支持16位有符号坐标。对于包含32位值的记录，如果值不在32,768至32,767范围内，则Windows 95/98 / Me无法播放记录。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）