描述
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)