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

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

Sintaxe

Status ConvertToEmfPlus(
  [in]  const Graphics *refGraphics,
  [out] 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.

[out] conversionFailureFlag

Tipo: BOOL*

Opcional. Ponteiro para um BOOL que recebe TRUE se todos os registros de metafile foram convertidos com êxito; FALSE caso contrário. Passe NULL se você não quiser receber essas informações. O valor padrão é NULL.

[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 metarquivo 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 metafile 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 se alguns registros individuais não tiverem sido convertidos com precisão completa. Por exemplo, o meta-arquivo original pode ter registros ou operações que não são compatíveis com o Windows GDI+ (ou EMF+), nesse caso, 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