Fonction EnumMetaFile (wingdi.h)

Article
03/04/2024

La fonction EnumMetaFile énumère les enregistrements dans un métafichier au format Windows en récupérant chaque enregistrement et en le transmettant à la fonction de rappel spécifiée. La fonction de rappel fournie par l’application traite chaque enregistrement en fonction des besoins. L’énumération continue jusqu’à ce que le dernier enregistrement soit traité ou que la fonction de rappel retourne zéro.

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

Syntaxe

BOOL EnumMetaFile(
  [in] HDC        hdc,
  [in] HMETAFILE  hmf,
  [in] MFENUMPROC proc,
  [in] LPARAM     param
);

Paramètres

[in] hdc

Handle vers un contexte de périphérique. Ce handle est passé à la fonction de rappel.

[in] hmf

Gérez un métafichier au format Windows.

[in] proc

Pointeur vers une fonction de rappel fournie par l’application. Pour plus d’informations, consultez EnumMetaFileProc.

[in] param

Pointeur vers des données facultatives.

Valeur retournée

Si la fonction de rappel énumère correctement tous les enregistrements dans le métafichier au format Windows, la valeur de retour est différente de zéro.

Si la fonction de rappel n’énumère pas correctement tous les enregistrements dans le métafichier au format Windows, la valeur de retour est zéro.

Remarques

Pour convertir un métafichier au format Windows en métafichier au format amélioré, utilisez la fonction SetWinMetaFileBits .

Vous pouvez utiliser la fonction EnumMetaFile pour incorporer un métafichier au format Windows dans un autre.

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