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

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

Sintassi

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

Tipo: IStream*

Puntatore a un'interfaccia IStream che specifica il flusso in cui viene scritto il metafile convertito.

conversionFailureFlag

TBD

[in] emfType

Tipo: EmfType

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

[in] description

Tipo: const WCHAR*

facoltativo. Puntatore a una stringa di caratteri wide-character 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, ovvero 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 da record EMF+ appena creati.

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

Requisiti

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