• 文档 /
  • CopyMetaFile-将Windows格式的元文件的内容复制到指定的文件

平台 SDK: Windows GDI

CopyMetaFile

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

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

HMETAFILE CopyMetaFile(
  HMETAFILE hmfSrc,  // Windows格式的图元文件句柄
  LPCTSTR lpszFile   // 文件名
);

Parameters

  • hmfSrc

  • [in] 源Windows格式的图元文件句柄。

  • lpszFile

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

返回值


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

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

Windows NT/2000/XP: 要获取扩展错误信息,请调用GetLastError

备注

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

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

Windows 95/98/Me: CopyMetaFileW由Microsoft Layer for Unicode支持。 要使用此功能,必须将某些文件添加到应用程序中,如Windows 95/98 / Me系统中的Microsoft Layer for Unicode所述。

要求

   Windows NT / 2000 / XP:包含在Windows NT 3.1及更高版本中。

   Windows 95/98 / Me:包含在Windows 95及更高版本中。

   头文件:声明于Wingdi.h; 包含于Windows.h。

   库:使用Gdi32.lib。  

  Unicode: 在Windows NT / 2000 / XP上实现为Unicode和ANSI版本。 还支持Microsoft Layer for Unicode。