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

Il metodo Metafile::ConvertToEmfPlus converte questo oggetto Metafile nel formato EMF+.

Sintassi

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

Parametri

[in] refGraphics

Tipo: grafica const *

Puntatore a un oggetto Graphics il cui stato (impostazioni per l'antialiasing, l'interpolazione e il tipo) viene applicato ai record archiviati nel metafile convertito.

[in] filename

Tipo: const WCHAR*

Puntatore a una stringa di caratteri wide con terminazione Null che specifica il nome di un file in cui viene salvato il metafile convertito.

conversionFailureFlag

TBD

[in] emfType

Tipo: EmfType

Facoltativa. Elemento dell'enumerazione EmfType che specifica se il file convertito ha il formato EmfTypeEmfPlusOnly o EmfTypeEmfPlusDual . Non passare EmfTypeEmfOnly. Il valore predefinito è EmfTypeEmfPlusOnly.

[in] description

Tipo: const WCHAR*

Facoltativa. Puntatore a una stringa di caratteri wide con terminazione Null archiviata nell'intestazione del metafile convertito. Il valore predefinito è NULL.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce OK, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Questo metodo sostituisce i record originariamente nell'oggetto Metafile con i record convertiti. Per conservare una copia dell'oggetto Metafile originale, chiamare il metodo Clone .

Se si imposta il parametro emfType su EmfTypeEmfPlusDual, il metafile convertito contiene una rappresentazione EMF (Enhanced Metafile) e una rappresentazione EMF+. La rappresentazione EMF è il set originale di record EMF anziché i record EMF convertiti dai record EMF+ appena creati.

È possibile che il valore restituito sia OK e che il valore restituito in conversionSuccess sia FALSE. A volte la conversione complessiva viene considerata corretta anche se alcuni singoli record non sono riusciti a eseguire la conversione con accuratezza completa. Ad esempio, il metafile originale potrebbe avere record o operazioni che non sono supportati da Windows GDI+ (o EMF+), nel qual caso tali record o operazioni vengono emulati.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll