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

指向接收转换后的记录的缓冲区的指针。 如果 lpbBufferNULLGetWinMetaFileBits 将返回存储转换后的图元文件记录所需的字节数。

[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

另请参阅

DeleteEnhMetaFile

图元文件函数

图元文件概述

SetMapMode

SetWinMetaFileBits