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

Die Metafile::ConvertToEmfPlus-Methode konvertiert dieses Metafile-Objekt in das EMF+-Format.

Syntax

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

Parameter

[in] refGraphics

Typ: const Graphics*

Zeiger auf ein Graphics-Objekt , dessen Zustand (Einstellungen für Antialiasing, Interpolation usw.) auf die in der konvertierten Metadatei gespeicherten Datensätze angewendet wird.

[in] stream

Typ: IStream*

Zeiger auf eine IStream-Schnittstelle , die den Stream angibt, in den die konvertierte Metadatei geschrieben wird.

conversionFailureFlag

TBD

[in] emfType

Typ: EmfType

Optional. Element der EmfType-Enumeration , das angibt, ob die konvertierte Datei das EmfTypeEmfPlusOnly-Format oder das EmfTypeEmfPlusDual-Format hat. Übergeben Sie EmfTypeEmfOnly nicht. Der Standardwert ist EmfTypeEmfPlusOnly.

[in] description

Typ: const WCHAR*

Optional. Zeiger auf eine mit NULL beendete Breitzeichenzeichenfolge, die im Header der konvertierten Metadatei gespeichert ist. Der Standardwert ist NULL.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Diese Methode ersetzt die Datensätze, die ursprünglich im Metafile-Objekt waren, durch die konvertierten Datensätze. Um eine Kopie des ursprünglichen Metafile-Objekts beizubehalten, rufen Sie die Clone-Methode auf.

Wenn Sie den emfType-Parameter auf EmfTypeEmfPlusDual festlegen, enthält die konvertierte Metadatei eine EMF-Darstellung (Enhanced Metafile) und eine EMF+-Darstellung. Die EMF-Darstellung ist der ursprüngliche Satz von EMF-Datensätzen anstelle von EMF-Datensätzen, die aus den neu erstellten EMF+-Datensätzen zurückgewandelt werden.

Es ist möglich, dass der Rückgabewert OK und der in conversionSuccess zurückgegebene Wert FALSE ist. Manchmal wird die Gesamtkonvertierung als erfolgreich betrachtet, auch wenn einige einzelne Datensätze nicht mit vollständiger Genauigkeit konvertiert werden konnten. Beispielsweise kann die ursprüngliche Metadatei Datensätze oder Vorgänge enthalten, die von Windows GDI+ (oder EMF+) nicht unterstützt werden. In diesem Fall werden diese Datensätze oder Vorgänge emuliert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll