勇芳软件工作室.汉化:  Metafiles > Metafile Functions >

SetWinMetaFileBits

Previous pageReturn to chapter overviewNext page

描述

 

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

 

C++ 语法

 

HENHMETAFILE SetWinMetaFileBits(

__in UINT cbBuffer,

__in const BYTE *lpbBuffer,

__in HDC hdcRef,

__in const METAFILEPICT *lpmfp

);

 

PowerBASIC 语法

 

FUNCTION SetWinMetaFileBits ( _

BYVAL cbBuffer AS DWORD, _

BYREF lpbBuffer AS BYTE, _

BYVAL hdcRef AS DWORD, _

BYREF lpmfp AS METAFILEPICT _

) AS LONG

 

参数

 

cbBuffer

 

[in]指定包含Windows格式图元文件的缓冲区的大小(以字节为单位)。

 

lpbBuffer

 

[in]指向包含Windows格式元文件数据的缓冲区的指针。(假设使用GetMetaFileBitsExGetWinMetaFileBits函数获取数据。)

 

hdcRef

 

[in]处理参考设备上下文。

 

lpmfp

 

[in]指向METAFILEPICT结构的指针,其中包含图像文件图片的建议大小和创建图片时使用的映射模式。

 

返回值

 

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

 

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

 

备注

 

Windows使用参考设备上下文的分辨率数据和METAFILEPICT结构中的数据来缩放图片。如果hdcRef参数为NULL,系统将使用当前输出设备的分辨率数据。如果lpmfp参数为NULL,系统将使用MM_ANISOTROPIC映射模式缩放图片,使其适合整个设备表面。METAFILEPICT结构中的hMF字段未使用。

 

当应用程序不再需要增强的图元文件句柄时,它应该通过调用DeleteEnhMetaFile函数来删除它。

 

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

 

如果参考设备上下文与最初创建图元文件的设备不相同,则使用设备单元的某些GDI功能可能无法正确绘制图片。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)