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

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

Syntaxe

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

Type : const WCHAR*

Pointeur vers une chaîne de caractères larges terminée par null qui spécifie le nom d’un fichier dans lequel le métafichier converti est enregistré.

conversionFailureFlag

TBD

[in] emfType

Type : EmfType

Optionnel. É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*

Optionnel. 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 .

Notes

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

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