Metafile::ConvertToEmfPlus(constGraphics*,constWCHAR*,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] const WCHAR    *filename,
       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] filename

Typ: const WCHAR*

Zeiger auf eine mit NULL endende Breitzeichenzeichenfolge, die den Namen einer Datei angibt, in der die konvertierte Metadatei gespeichert 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 aufweist. Übergeben Sie EmfTypeEmfOnly nicht. Der Standardwert ist EmfTypeEmfPlusOnly.

[in] description

Typ: const WCHAR*

Optional. Zeiger auf eine mit NULL endende 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, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Diese Methode ersetzt die Datensätze, die ursprünglich im Metafile-Objekt enthalten 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 und nicht EMF-Datensätzen, die von den neu erstellten EMF+-Datensätzen zurückkonvertiert wurden.

Es ist möglich, dass der Rückgabewert OK und der in conversionSuccess zurückgegebene Wert FALSE ist. Manchmal wird die Gesamtkonvertierung als erfolgreich angesehen, auch wenn einige einzelne Datensätze nicht mit vollständiger Genauigkeit konvertiert werden konnten. Die ursprüngliche Metadatei kann beispielsweise 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

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