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

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

Синтаксис

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

Параметры

[in] refGraphics

Тип: const Graphics*

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

[out] conversionFailureFlag

Тип: BOOL*

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

[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