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

The Metafile::ConvertToEmfPlus method converts this Metafile object to the EMF+ format.

Syntax

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

Parameters

[in] refGraphics

Type: const Graphics*

Pointer to a Graphics object whose state (settings for antialiasing, interpolation, and the like) is applied to the records stored in the converted metafile.

[in] filename

Type: const WCHAR*

Pointer to a null-terminated wide-character string that specifies the name of a file to which the converted metafile is saved.

conversionFailureFlag

TBD

[in] emfType

Type: EmfType

Optional. Element of the EmfType enumeration that specifies whether the converted file has the EmfTypeEmfPlusOnly format or the EmfTypeEmfPlusDual format. Do not pass EmfTypeEmfOnly. The default value is EmfTypeEmfPlusOnly.

[in] description

Type: const WCHAR*

Optional. Pointer to a null-terminated wide-character string that is stored in the header of the converted metafile. The default value is NULL.

Return value

Type: Status

If the method succeeds, it returns OK, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.

Remarks

This method replaces the records originally in the Metafile object with the converted records. To retain a copy of the original Metafile object, call the Clone method.

If you set the emfType parameter to EmfTypeEmfPlusDual, the converted metafile contains an Enhanced Metafile (EMF) representation and an EMF+ representation. The EMF representation is the original set of EMF records rather than EMF records converted back from the newly created EMF+ records.

It is possible for the return value to be Ok and the value returned in conversionSuccess to be FALSE. Sometimes the overall conversion is considered to be successful even if a few individual records failed to convert with complete accuracy. For example, the original metafile might have records or operations that are not supported by Windows GDI+ (or EMF+), in which case those records or operations are emulated.

Requirements