Fonction EnumEnhMetaFile (wingdi.h)
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 |