Méthode Metafile ::ConvertToEmfPlus(constGraphics*,IStream*,INT*,EmfType,constWCHAR*) (gdiplusheaders.h)

La méthode Metafile ::ConvertToEmfPlus convertit cet objet Metafile au format EMF+.

Syntaxe

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

Paramètres

[in] refGraphics

Type : const Graphics*

Pointeur vers un objet Graphics dont l’état (paramètres d’anticrénelage, d’interpolation et similaires) est appliqué aux enregistrements stockés dans le métafichier converti.

[in] stream

Type : IStream*

Pointeur vers une interface IStream qui spécifie le flux dans lequel le métafichier converti est écrit.

conversionFailureFlag

TBD

[in] emfType

Type : EmfType

facultatif. Élément de l’énumération EmfType qui spécifie si le fichier converti a le format EmfTypeEmfPlusOnly ou emfTypeEmfPlusDual . Ne passez pas EmfTypeEmfOnly. La valeur par défaut est EmfTypeEmfPlusOnly.

[in] description

Type : const WCHAR*

facultatif. Pointeur vers une chaîne de caractères larges terminée par null qui est stockée dans l’en-tête du métafichier converti. La valeur par défaut est NULL.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne OK, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

Cette méthode remplace les enregistrements initialement dans l’objet Metafile par les enregistrements convertis. Pour conserver une copie de l’objet Metafile d’origine, appelez la méthode Clone .

Si vous définissez le paramètre emfType sur EmfTypeEmfPlusDual, le métafichier converti contient une représentation EMF (Enhanced Metafile) et une représentation EMF+. La représentation EMF est le jeu d’enregistrements EMF d’origine plutôt que les enregistrements EMF reconvertis à partir des enregistrements EMF+ nouvellement créés.

Il est possible que la valeur de retour soit Ok et que la valeur retournée dans conversionSuccess soit FALSE. Parfois, la conversion globale est considérée comme réussie même si quelques enregistrements individuels n’ont pas pu être convertis avec une précision totale. Par exemple, le métafichier d’origine peut contenir des enregistrements ou des opérations qui ne sont pas pris en charge par Windows GDI+ (ou EMF+), auquel cas ces enregistrements ou opérations sont émulés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll