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 |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de