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

O método Metafile::ConvertToEmfPlus converte esse objeto Metafile no formato EMF+.

Sintaxe

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

Parâmetros

[in] refGraphics

Tipo: const Graphics*

Ponteiro para um objeto Graphics cujo estado (configurações para suavização, interpolação e similares) é aplicado aos registros armazenados no metarquivo convertido.

[in] stream

Tipo: IStream*

Ponteiro para uma interface IStream que especifica o fluxo no qual o meta-arquivo convertido é gravado.

conversionFailureFlag

TBD

[in] emfType

Tipo: EmfType

Opcional. Elemento da enumeração EmfType que especifica se o arquivo convertido tem o formato EmfTypeEmfPlusOnly ou o formato EmfTypeEmfPlusDual . Não passe EmfTypeEmfOnly. O valor padrão é EmfTypeEmfPlusOnly.

[in] description

Tipo: const WCHAR*

Opcional. Ponteiro para uma cadeia de caracteres largos terminada em nulo que é armazenada no cabeçalho do meta-arquivo convertido. O valor padrão é NULL.

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará OK, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Esse método substitui os registros originalmente no objeto Metafile pelos registros convertidos. Para manter uma cópia do objeto Metafile original, chame o método Clone .

Se você definir o parâmetro emfType como EmfTypeEmfPlusDual, o metarquivo convertido conterá uma representação em EMF (Metafile Avançado) e uma representação EMF+. A representação EMF é o conjunto original de registros EMF em vez de registros EMF convertidos de volta dos registros EMF+ recém-criados.

É possível que o valor retornado seja Ok e o valor retornado em conversionSuccess seja FALSE. Às vezes, a conversão geral é considerada bem-sucedida mesmo que alguns registros individuais não consigam ser convertidos com precisão completa. Por exemplo, o meta-arquivo original pode ter registros ou operações que não têm suporte do Windows GDI+ (ou EMF+), caso em que esses registros ou operações são emulados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll