getEnhMetaFileA 函数 (wingdi.h)

GetEnhMetaFile 函数创建一个句柄,用于标识存储在指定文件中的增强格式图元文件。

语法

HENHMETAFILE GetEnhMetaFileA(
  [in] LPCSTR lpName
);

参数

[in] lpName

指向以 null 结尾的字符串的指针,该字符串指定增强型图元文件的名称。

返回值

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

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

注解

当应用程序不再需要增强型图元文件句柄时,它应通过调用 DeleteEnhMetaFile 函数删除该句柄。

必须先将 Windows 格式图元文件转换为增强格式,然后才能由 GetEnhMetaFile 函数处理。 若要转换文件,请使用 SetWinMetaFileBits 函数。

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

示例

有关示例,请参阅 打开增强型图元文件和显示其内容

注意

wingdi.h 标头将 GetEnhMetaFile 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

DeleteEnhMetaFile

GetEnhMetaFile

图元文件函数

图元文件概述

SetWinMetaFileBits