Partager via


CopyMetaFileA, fonction (wingdi.h)

La fonction CopyMetaFile copie le contenu d’un métafichier au format Windows dans le fichier spécifié.

Note Cette fonction est fournie uniquement pour la compatibilité avec les métafichiers au format Windows. Les métafichiers au format amélioré offrent des fonctionnalités supérieures et sont recommandés pour les nouvelles applications. La fonction correspondante pour un métafichier au format amélioré est CopyEnhMetaFile.
 

Syntaxe

HMETAFILE CopyMetaFileA(
  [in] HMETAFILE unnamedParam1,
  [in] LPCSTR    unnamedParam2
);

Paramètres

[in] unnamedParam1

Handle pour le métafichier au format Windows source.

[in] unnamedParam2

Pointeur vers le nom du fichier de destination. Si ce paramètre a la valeur NULL, le métafichier source est copié en mémoire.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour la copie du métafichier au format Windows.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

Lorsque les arguments de texte doivent utiliser des caractères Unicode, utilisez cette fonction comme fonction à caractères larges. Lorsque les arguments de texte doivent utiliser des caractères du jeu de caractères Windows, utilisez cette fonction comme fonction ANSI.

Lorsque l’application n’a plus besoin du handle de métafichier au format Windows, elle doit supprimer le handle en appelant la fonction DeleteMetaFile .

Notes

L’en-tête wingdi.h définit CopyMetaFile en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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

Voir aussi

DeleteMetaFile

Fonctions de métafichier

Vue d’ensemble des métafichiers