Méthode Metafile ::ConvertToEmfPlus(constGraphics*,INT*,EmfType,constWCHAR*) (gdiplusheaders.h)
La méthode Metafile ::ConvertToEmfPlus convertit cet objet Metafile au format EMF+.
Syntaxe
Status ConvertToEmfPlus(
[in] const Graphics *refGraphics,
[out] 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éation, d’interpolation, etc.) est appliqué aux enregistrements stockés dans le métafichier converti.
[out] conversionFailureFlag
Type : BOOL*
facultatif. Pointeur vers un BOOL qui reçoit TRUE si tous les enregistrements de métafichiers ont été convertis avec succès ; FALSE dans le cas contraire. Passez la valeur NULL si vous ne souhaitez pas recevoir ces informations. La valeur par défaut est NULL.
[in] emfType
Type : EmfType
facultatif. Élément de l’énumération EmfType qui spécifie si le fichier converti a le format EmfTypeEmfPlusOnly ou le format 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 à l’origine 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’origine d’enregistrements EMF plutôt que les enregistrements EMF convertis à 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 avoir 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 |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour