Metafile：：ConvertToEmfPlus (constGraphics*，IStream*，INT*，EmfType，constWCHAR*) 方法 (gdiplusheaders.h)

Metafile：：ConvertToEmfPlus 方法将此图元文件对象转换为 EMF+ 格式。

语法

Status ConvertToEmfPlus(
  [in] const Graphics *refGraphics,
  [in] IStream        *stream,
       INT            *conversionFailureFlag,
  [in] EmfType        emfType,
  [in] const WCHAR    *description
);

参数

[in] refGraphics

类型： const Graphics*

指向 Graphics 对象的指针，该对象的状态 (抗锯齿、内插等) 的设置应用于已转换的图元文件中存储的记录。

[in] stream

类型： IStream*

指向 IStream 接口的指针，该接口指定要将转换的图元文件写入到的流。

conversionFailureFlag

TBD

[in] emfType

类型： EmfType

可选。 EmfType 枚举的元素，指定转换后的文件是具有 EmfTypeEmfPlusOnly 格式还是 EmfTypeEmfPlusDual 格式。 不要传递 EmfTypeEmfOnly。 默认值为 EmfTypeEmfPlusOnly。

[in] description

类型： const WCHAR*

可选。 指向以 null 结尾的宽字符字符串的指针，该字符串存储在转换后的图元文件的标头中。 默认值为 NULL。

返回值

类型： 状态

如果该方法成功，则返回 OK，这是 Status 枚举的元素。

如果方法失败，它将返回 Status 枚举的其他元素之一。

注解

此方法将最初在 图元文件 对象中的记录替换为转换后的记录。 若要保留原始 图元文件 对象的副本，请调用 Clone 方法。

如果将 emfType 参数设置为 EmfTypeEmfPlusDual，则转换后的图元文件包含增强型图元文件 (EMF) 表示形式和 EMF+ 表示形式。 EMF 表示形式是原始的 EMF 记录集，而不是从新创建的 EMF+ 记录转换回的 EMF 记录。

返回值可能为 Ok，conversionSuccess 中返回的值可能为 FALSE。 有时，即使一些单独的记录未能完全准确地转换，整体转换也会被视为成功。 例如，原始图元文件可能包含 Windows GDI+ (或 EMF+) 不支持的记录或操作，在这种情况下，将模拟这些记录或操作。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	gdiplusheaders.h (包括 Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll