GetWinMetaFileBits 函数 (wingdi.h)
GetWinMetaFileBits 函数将增强格式的记录从图元文件转换为 Windows 格式记录,并将转换后的记录存储在指定的缓冲区中。
语法
UINT GetWinMetaFileBits(
[in] HENHMETAFILE hemf,
[in] UINT cbData16,
[out] LPBYTE pData16,
[in] INT iMapMode,
[in] HDC hdcRef
);
参数
[in] hemf
增强型图元文件的句柄。
[in] cbData16
转换后的记录要复制到的缓冲区的大小(以字节为单位)。
[out] pData16
指向接收转换后的记录的缓冲区的指针。 如果 lpbBuffer 为 NULL, GetWinMetaFileBits 将返回存储转换后的图元文件记录所需的字节数。
[in] iMapMode
在转换后的图元文件中使用的映射模式。
[in] hdcRef
引用设备上下文的句柄。
返回值
如果函数成功且缓冲区指针为 NULL,则返回值是存储转换的记录所需的字节数:如果函数成功,并且缓冲区指针是有效的指针,则返回值是图元文件数据的大小(以字节为单位)。
如果函数失败,则返回值为零。
注解
此函数将增强的图元文件转换为 Windows 格式的图元文件,以便其图片可以在识别旧格式的应用程序中显示。
系统使用引用设备上下文来确定转换后的图元文件的分辨率。
GetWinMetaFileBits 函数不会使增强的图元文件句柄失效。 应用程序应调用 DeleteEnhMetaFile 函数,以在不再需要句柄时释放该句柄。
若要创建可缩放的 Windows 格式图元文件,请将 MM_ANISOTROPIC 指定为 fnMapMode 参数。
图元文件图片的左上角始终映射到引用设备的原点。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | wingdi.h (包括 Windows.h) |
Library | Gdi32.lib |
DLL | Gdi32.dll |