Fonction PlayEnhMetaFile (wingdi.h)

Article
08/27/2023

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