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

GetMetaFileBitsEx

Previous pageReturn to chapter overviewNext page

描述

 

GetMetaFileBitsEx函数检索Windows格式的图元文件的内容,并将它们复制到指定的缓冲区。

 

注意此函数仅用于与Windows格式的图元文件兼容。增强格式的图元文件提供卓越的功能,并推荐用于新的应用程序。增强格式的图元文件的相应功能是GetEnhMetaFileBits.

 

C++ 语法

 

UINT GetMetaFileBitsEx(

__in  HMETAFILE hmf,

__in  UINT nSize,

__out LPVOID lpvData

);

 

PowerBASIC 语法

 

FUNCTION GetMetaFileBitsEx ( _

BYVAL hmf AS DWORD, _

BYVAL nSize AS DWORD, _

BYREF lpvData AS ANY _

) AS DWORD

 

参数

 

hmf

 

[in]处理Windows格式的图元文件。

 

nSize

 

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

 

lpvData

 

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

 

返回值

 

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

 

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

 

备注

 

在检索到Windows元文件位后,可以通过调用SetMetaFileBitsEx函数来创建基于内存的元文件。

 

GetMetaFileBitsEx函数不会使图元文件句柄无效。应用程序必须通过调用DeleteMetaFile功能删除此句柄。

 

要将Windows格式的图元文件转换为增强格式的图元文件,请使用SetWinMetaFileBits函数。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)