Fonction PlayEnhMetaFile (wingdi.h)
La fonction PlayEnhMetaFile affiche l’image stockée dans le métafichier au format amélioré spécifié.
Syntaxe
BOOL PlayEnhMetaFile(
[in] HDC hdc,
[in] HENHMETAFILE hmf,
[in] const RECT *lprect
);
Paramètres
[in] hdc
Handle du contexte de l’appareil pour l’appareil de sortie sur lequel l’image apparaîtra.
[in] hmf
Handle du métafichier amélioré.
[in] lprect
Pointeur vers une structure RECT qui contient les coordonnées du rectangle englobant utilisé pour afficher l’image. Les coordonnées sont spécifiées en unités logiques.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
Remarques
Lorsqu’une application appelle la fonction PlayEnhMetaFile , le système utilise le cadre d’image dans l’en-tête enhanced-metafile pour mapper l’image sur le rectangle vers lequel pointe le paramètre lpRect . (Cette image peut être ccietée ou pivotée en définissant la transformation mondiale dans l’appareil de sortie avant d’appeler PlayEnhMetaFile.) Des points le long des bords du rectangle sont inclus dans l’image.
Une image de métafichier amélioré peut être rogné en définissant la zone de découpage dans l’appareil de sortie avant de lire le métafichier amélioré.
Si un métafichier amélioré contient une palette facultative, une application peut obtenir des couleurs cohérentes en configurant une palette de couleurs sur l’appareil de sortie avant d’appeler PlayEnhMetaFile. Pour récupérer la palette facultative, utilisez la fonction GetEnhMetaFilePaletteEntries .
Un métafichier amélioré peut être incorporé dans un métafichier amélioré nouvellement créé en appelant PlayEnhMetaFile et en lisant le métafichier amélioré source dans le contexte de l’appareil pour le nouveau métafichier amélioré.
Les états du contexte de l’appareil de sortie sont conservés par cette fonction. Tout objet créé mais non supprimé dans le métafichier amélioré est supprimé par cette fonction.
Pour arrêter cette fonction, une application peut appeler la fonction CancelDC à partir d’un autre thread pour mettre fin à l’opération. Dans ce cas, la fonction retourne FALSE.
Exemples
Pour obtenir un exemple, consultez Ouverture d’un métafichier amélioré et affichage de son contenu.
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 |