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

GetWinMetaFileBits

Previous pageReturn to chapter overviewNext page

描述

 

GetWinMetaFileBits函数将增强格式记录从图元文件转换为Windows格式记录,并将转换的记录存储在指定的缓冲区中。

 

C++ 语法

 

UINT GetWinMetaFileBits(

__in  HENHMETAFILE hemf,

__in  UINT cbBuffer,

__out LPBYTE lpbBuffer,

__in  INT fnMapMode,

__in  HDC hdcRef

);

 

PowerBASIC 语法

 

FUNCTION GetWinMetaFileBits ( _

BYVAL hemf AS DWORD, _

BYVAL cbBuffer AS DWORD, _

BYREF lpbBuffer AS BYTE, _

BYVAL fnMapMode AS LONG, _

BYVAL hdcRef AS DWORD _

) AS DWORD

 

参数

 

hemf

 

[in]处理增强型图元文件。

 

cbBuffer

 

[in]指定要复制转换的记录的缓冲区的大小(以字节为单位)。

 

lpbBuffer

 

[out]指向接收转换记录的缓冲区的指针。如果lpbBuffer为NULL,GetWinMetaFileBits返回存储转换的元文件记录所需的字节数。

 

fnMapMode

 

[in]指定要在转换的图元文件中使用的映射模式。

 

lpbBuffer

 

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

 

返回值

 

如果函数成功并且缓冲区指针为NULL,则返回值是存储转换记录所需的字节数;如果函数成功并且缓冲区指针是有效的指针,则返回值是以元字节表示的元文件数据的大小。

 

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

 

备注

 

此函数将增强的图元文件转换为Windows格式的图元文件,以便其图片可以显示在识别旧格式的应用程序中。

 

系统使用参考设备上下文来确定转换图元文件的分辨率。

 

GetWinMetaFileBits功能不会使增强的图元文件句柄无效。一个应用程序应该调用DeleteEnhMetaFile函数来释放句柄,当它不再需要时。

 

要创建可扩展的Windows格式的元文件,请指定MM_ANISOTROPIC作为fnMapMode参数。

 

元文件图片的左上角始终映射到参考设备的原点。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)