Metafile::ConvertToEmfPlus(constGraphics*,IStream*,INT*,EmfType,constWCHAR*) (gdiplusheaders.h)

El método Metafile::ConvertToEmfPlus convierte este objeto Metafile al formato EMF+.

Sintaxis

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

Parámetros

[in] refGraphics

Tipo: gráficos* const

Puntero a un objeto Graphics cuyo estado (configuración de suavizado, interpolación y similares) se aplica a los registros almacenados en el metarchivo convertido.

[in] stream

Tipo: IStream*

Puntero a una interfaz IStream que especifica la secuencia a la que se escribe el metarchivo convertido.

conversionFailureFlag

TBD

[in] emfType

Tipo: EmfType

Opcional. Elemento de la enumeración EmfType que especifica si el archivo convertido tiene el formato EmfTypeEmfPlusOnly o el formato EmfTypeEmfPlusDual . No pase EmfTypeEmfOnly. El valor predeterminado es EmfTypeEmfPlusOnly.

[in] description

Tipo: const WCHAR*

Opcional. Puntero a una cadena de caracteres anchos terminada en null que se almacena en el encabezado del metarchivo convertido. El valor predeterminado es NULL.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve OK, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Este método reemplaza los registros originalmente en el objeto Metafile por los registros convertidos. Para conservar una copia del objeto metafile original, llame al método Clone .

Si establece el parámetro emfType en EmfTypeEmfPlusDual, el metarchivo convertido contiene una representación de metarchivo mejorado (EMF) y una representación EMF+. La representación EMF es el conjunto original de registros EMF en lugar de los registros EMF convertidos a partir de los registros EMF+ recién creados.

Es posible que el valor devuelto sea Ok y el valor devuelto en conversionSuccess sea FALSE. A veces, la conversión general se considera correcta incluso si algunos registros individuales no se pudieron convertir con precisión completa. Por ejemplo, el metarchivo original podría tener registros o operaciones que no son compatibles con Windows GDI+ (o EMF+), en cuyo caso se emulan esos registros o operaciones.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll