Fonction EnumEnhMetaFile (wingdi.h)

Article
08/27/2023

La fonction EnumEnhMetaFile énumère les enregistrements dans un métafichier au format amélioré 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.

Syntaxe

BOOL EnumEnhMetaFile(
  [in] HDC           hdc,
  [in] HENHMETAFILE  hmf,
  [in] ENHMFENUMPROC proc,
  [in] LPVOID        param,
  [in] const RECT    *lpRect
);

Paramètres

[in] hdc

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

[in] hmf

Handle d'un métafichier amélioré.

[in] proc

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

[in] param

Pointeur vers les données facultatives de fonction de rappel.

[in] lpRect

Pointeur vers une structure RECT qui spécifie les coordonnées, en unités logiques, des coins supérieur gauche et inférieur droit de l’image.

Valeur retournée

Si la fonction de rappel énumère correctement tous les enregistrements dans le métafichier amélioré, 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 amélioré, la valeur de retour est zéro.

Remarques

Les points le long du bord du rectangle vers lequel pointe le paramètre lpRect sont inclus dans l’image. Si le paramètre hdc a la valeur NULL, le système ignore lpRect.

Si la fonction de rappel appelle la fonction PlayEnhMetaFileRecord , hdc doit identifier un contexte d’appareil valide. Le système utilise le mode de transformation et de mappage du contexte de l’appareil pour transformer l’image affichée par la fonction PlayEnhMetaFileRecord .

Vous pouvez utiliser la fonction EnumEnhMetaFile pour incorporer un métafichier amélioré dans un autre.

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