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

CopyMetaFile

Previous pageReturn to chapter overviewNext page

描述

 

CopyMetaFile功能将Windows格式的元文件的内容复制到指定的文件。

 

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

 

C++ 语法

 

HMETAFILE CopyMetaFile(

__in HMETAFILE hmfSrc,

__in LPCTSTR lpszFile

);

 

PowerBASIC 语法

 

FUNCTION CopyMetaFileA ( _

BYVAL hmfSrc AS DWORD, _

BYREF lpszFile AS ASCIIZ _

) AS DWORD

 

Unicode版本:

 

FUNCTION CopyMetaFileW ( _

BYVAL hmfSrc AS DWORD, _

BYREF lpszFile AS WSTRINGZ _

) AS DWORD

 

参数

 

hmfSrc

 

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

 

lpszFile

 

[in]指向目标文件名称的指针。如果此参数为NULL,则源图元文件将被复制到内存中。

 

返回值

 

如果函数成功,则返回值是增强图元文件副本的句柄。

 

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

 

备注

 

在文本参数必须使用Unicode字符的地方,将此函数用作宽字符函数。如果文本参数必须使用Windows字符集中的字符,请使用此函数作为ANSI函数。

 

当应用程序不再需要Windows格式的元文件句柄时,它应该通过调用DeleteMetaFile功能删除句柄。

 

Windows 95/98 / Me:Microsoft Layer for Unicode支持CopyMetaFileW.

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)