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 |
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