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

GetEnhMetaFileBits

Previous pageReturn to chapter overviewNext page

描述

 

GetEnhMetaFileBits函数检索指定的增强格式的元文件的内容并将其复制到缓冲区中。

 

C++ 语法

 

UINT GetEnhMetaFileBits(

__in  HENHMETAFILE hemf,

__in  UINT cbBuffer,

__out LPBYTE lpbBuffer

);

 

PowerBASIC 语法

 

FUNCTION GetEnhMetaFileBits ( _

BYVAL hemf AS DWORD, _

BYVAL cbBuffer AS DWORD, _

BYREF lpbBuffer AS BYTE _

) AS DWORD

 

参数

 

hemf

 

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

 

cbBuffer

 

[in]指定接收数据的缓冲区的大小(以字节为单位)。

 

lpbBuffer

 

[out]指向接收元文件数据的缓冲区的指针。缓冲区必须足够大以容纳数据。如果lpbBuffer为NULL,则该函数返回保存数据所需的大小。

 

返回值

 

如果函数成功并且缓冲区指针为NULL,则返回值是增强的图元文件的大小(以字节为单位)。

 

如果函数成功并且缓冲区指针是有效的指针,则返回值是复制到缓冲区的字节数。

 

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

 

备注

 

在检索到增强型图元文件位之后,可以通过调用SetEnhMetaFileBits函数来创建基于内存的图元文件。

 

GetEnhMetaFileBits功能不会使增强型图元文件句柄无效。应用程序必须调用DeleteEnhMetaFile函数来在不再需要时删除句柄。

 

由此函数检索的元文件内容采用增强格式。要以Windows格式检索图元文件内容,请使用GetWinMetaFileBits功能。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)