CreateMetaFileW, fonction (wingdi.h)

Article
08/27/2023

La fonction CreateMetaFile crée un contexte d’appareil pour un métafichier au format Windows.

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

Syntaxe

HDC CreateMetaFileW(
  [in] LPCWSTR pszFile
);

Paramètres

[in] pszFile

Pointeur vers le nom de fichier pour le métafichier au format Windows à créer. Si ce paramètre a la valeur NULL, le métafichier au format Windows est basé sur la mémoire et son contenu est perdu lorsqu’il est supprimé à l’aide de la fonction DeleteMetaFile .

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour le contexte de l’appareil pour le 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 la fonction CreateMetaFile 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.

CreateMetaFile est une fonction de métafichier au format Windows. Cette fonction prend en charge uniquement les applications Windows 16 bits, qui sont répertoriées dans les métafichiers au format Windows. Il n’enregistre pas ni ne rejoue les fonctions GDI telles que PolyBezier, qui ne faisaient pas partie de Windows 16 bits.

Le contexte d’appareil créé par cette fonction peut être utilisé pour enregistrer les fonctions de sortie GDI dans un métafichier au format Windows. Il ne peut pas être utilisé avec des fonctions de requête GDI telles que GetTextColor. Lorsque le contexte de l’appareil est utilisé avec une fonction de sortie GDI, la valeur de retour de cette fonction devient TRUE si la fonction est enregistrée et FALSE dans le cas contraire. Lorsqu’un objet est sélectionné à l’aide de la fonction SelectObject , seule une copie de l’objet est enregistrée. L’objet appartient toujours à l’application.

Pour créer un métafichier au format Windows évolutif, enregistrez la sortie graphique en mode de mappage MM_ANISOTROPIC. Le fichier ne peut pas contenir de fonctions qui modifient l’origine et les extensions de la fenêtre d’affichage, ni contenir des fonctions dépendantes de l’appareil telles que la fonction SelectClipRgn . Une fois créé, le métafichier Windows peut être mis à l’échelle et rendu à n’importe quel format de périphérique de sortie en définissant l’origine et les étendues de la fenêtre d’affichage de l’image avant de la lire.

Notes

L’en-tête wingdi.h définit CreateMetaFile 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


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