setWinMetaFileBits 函数 (wingdi.h)

项目
03/04/2024

SetWinMetaFileBits 函数将元文件从较旧的 Windows 格式转换为新的增强格式，并将新的图元文件存储在内存中。

语法

HENHMETAFILE SetWinMetaFileBits(
  [in] UINT               nSize,
  [in] const BYTE         *lpMeta16Data,
  [in] HDC                hdcRef,
  [in] const METAFILEPICT *lpMFP
);

参数

[in] nSize

包含 Windows 格式图元文件的缓冲区的大小（以字节为单位）。

[in] lpMeta16Data

指向包含 Windows 格式图元文件数据的缓冲区的指针。 (假定数据是使用 GetMetaFileBitsEx 或 GetWinMetaFileBits function.)

[in] hdcRef

引用设备上下文的句柄。

[in] lpMFP

指向 METAFILEPICT 结构的指针，该结构包含图元文件图片的建议大小以及创建图片时使用的映射模式。

返回值

如果函数成功，则返回值是基于内存的增强型图元文件的句柄。

如果函数失败，则返回值为 NULL。

注解

Windows 使用引用设备上下文的分辨率数据和 METAFILEPICT 结构中的数据来缩放图片。如果 hdcRef 参数为 NULL，则系统使用当前输出设备的分辨率数据。如果 lpmfp 参数为 NULL，则系统使用MM_ANISOTROPIC映射模式缩放图片，使其适合整个设备图面。不使用 METAFILEPICT 结构的 hMF 成员。

当应用程序不再需要增强型图元文件句柄时，它应通过调用 DeleteEnhMetaFile 函数将其删除。

此函数返回的句柄可以与其他增强型图元文件函数一起使用。

如果引用设备上下文与最初创建图元文件的设备不同，则某些使用设备单位的 GDI 函数可能无法正确绘制图片。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll