Метод Metafile::ConvertToEmfPlus(constGraphics*,IStream*,INT*,EmfType,constWCHAR*) (gdiplusheaders.h)

Метод Metafile::ConvertToEmfPlus преобразует этот объект Metafile в формат EMF+.

Синтаксис

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

Параметры

[in] refGraphics

Тип: const Graphics*

Указатель на графический объект, состояние которого (параметры для сглаживания, интерполяции и т. д.) применяется к записям, хранящимся в преобразованном метафайлом.

[in] stream

Тип: IStream*

Указатель на интерфейс IStream , указывающий поток, в который записывается преобразованный метафайл.

conversionFailureFlag

TBD

[in] emfType

Тип: EmfType

Необязательный элемент. Элемент перечисления EmfType , указывающий, имеет ли преобразованный файл формат EmfTypeEmfPlusOnly или EmfTypeEmfPlusDual . Не передайте EmfTypeEmfOnly. Значение по умолчанию — EmfTypeEmfPlusOnly.

[in] description

Тип: const WCHAR*

Необязательный элемент. Указатель на строку расширенных символов, завершающуюся null, которая хранится в заголовке преобразованного метафайла. Значение по умолчанию — NULL.

Возвращаемое значение

Тип: Состояние

Если метод завершается успешно, возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Комментарии

Этот метод заменяет записи, изначально в объекте Metafile , преобразованными записями. Чтобы сохранить копию исходного объекта Metafile , вызовите метод Clone .

Если для параметра emfType задано значение EmfTypeEmfPlusDual, преобразованный метафайл содержит представление расширенного метафайла (EMF) и представление EMF+. Представление EMF — это исходный набор записей EMF, а не записей EMF, преобразованных обратно из вновь созданных записей EMF+.

Возвращаемое значение может быть ОК , а значение, возвращаемое в conversionSuccess , — FALSE. Иногда общее преобразование считается успешным, даже если несколько отдельных записей не удалось преобразовать с полной точностью. Например, исходный метафайл может содержать записи или операции, которые не поддерживаются Windows GDI+ (или EMF+), в этом случае эти записи или операции эмулируются.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	gdiplusheaders.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll