BOOL PlayMetaFile ( HMETAFILE hMF );
BOOL PlayMetaFile ( HENHMETAFILE hEnhMetaFile, LPCRECT lpBounds );
Valeur de retour
Différent de zéro si la fonction est réussie ; sinon 0.
Paramètres
hMF
Identifie le métafichier pour être joué.
hEnhMetaFile
Identifie le métafichier amélioré.
lpBounds
Pointe vers une structure RECT ou un objet CRect qui contient les coordonnées du rectangle englobant pour afficher l'image. Les coordonnées sont spécifiées dans les unités logiques.
Remarques
Il joue le contenu du métafichier spécifié sur le contexte de périphérique. Le métafichier peut être joué n'importe quel nombre de fois.
La deuxième version de PlayMetaFile affiche l'image stockée dans le métafichier amélioré-format donné. Lorsqu'une application appelle la deuxième version de PlayMetaFile, Windows utilise le cadre d'image dans l'en-tête de métafichier amélioré à la carte de l'image dans le rectangle indiqué par le paramètre lpBounds . (Cette image peut être cisaillée ou une rotation en définissant la transformation du monde dans le périphérique de sortie avant d'appeler PlayMetaFile.) Points sur les bords du rectangle sont inclus dans l'image. Une image de métafichier amélioré peut être découpée en définissant la zone de découpage dans le périphérique de sortie avant de jouer le métafichier amélioré.
Si un métafichier amélioré contient une palette facultative, une application peut atteindre couleurs compatibles par la création d'une palette de couleurs sur le périphérique de sortie avant d'appeler la deuxième version de PlayMetaFile. Pour récupérer la palette d'option, utilisez le :: GetEnhMetaFilePaletteEntries fonction. Un métafichier amélioré peut être incorporé dans un métafichier amélioré nouvellement créé en appelant la deuxième version de PlayMetaFile et en jouant le métafichier amélioré de source dans le contexte de périphérique pour le nouveau metafile amélioré.
Les États du contexte de périphérique de sortie sont conservés par cette fonction. Tout objet créé mais ne pas supprimés dans le métafichier amélioré est supprimé par cette fonction. Pour arrêter cette fonction, une application peut appeler le :: CancelDC fonction d'un autre thread de mettre fin à l'opération. Dans ce cas, la fonction retourne zéro.
Aperçu de la CDC | ; Membres de la classe | Graphique de la hiérarchie
See Also ::CancelDC, ::GetEnhMetaFileHeader, ::GetEnhMetaFilePaletteEntries, ::SetWorldTransform, ::PlayMetaFile, ::PlayEnhMetaFile, ::PlayMetaFile