CDC::PlayMetaFile
Lit le contenu du métafichier spécifié dans le contexte de périphérique.
BOOL PlayMetaFile(
HMETAFILE hMF
);
BOOL PlayMetaFile(
HENHMETAFILE hEnhMetaFile,
LPCRECT lpBounds
);
Paramètres
hMF
Identifie le métafichier à lire.hEnhMetaFile
Identifie le métafichier amélioré.lpBounds
Les points à RECT structure ou un objet d' CRect 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 de retour
Une valeur différente de zéro si la fonction est réussie ; sinon 0.
Notes
Métafichier peut être lu plusieurs fois.
La deuxième version d' PlayMetaFile affiche l'image stockée dans le métafichier donné d'améliorer- format. Lorsqu'une application appelle la deuxième version d' PlayMetaFile, windows utilise la zone de table dans l'en-tête de métafichier amélioré pour mapper l'image sur le rectangle globale pointe vers le paramètre d' lpBounds . (Cette image peut être distordue ou pivotée en définissant la transformation du monde dans le périphérique de sortie avant d'appeler PlayMetaFile.) Les points le long de les bords du rectangle sont inclus dans l'image. Une image de métafichier amélioré peut être découpé en définissant la région de découpage du périphérique de sortie avant de lire le métafichier amélioré.
Si un métafichier amélioré contient une palette facultative, une application peut accomplir des couleurs cohérentes en installant une palette de couleurs sur le périphérique de sortie avant d'appeler la deuxième version d' PlayMetaFile. Pour récupérer la palette facultative, utilisez la fonction Windows de GetEnhMetaFilePaletteEntries . Un métafichier amélioré peut être incorporé dans un métafichier amélioré nouvellement créé en appelant la deuxième version d' PlayMetaFile et en lisant le métafichier amélioré de source dans le contexte de périphérique pour le nouveau métafichier amélioré.
Les états du contexte de périphérique de sortie sont conservés par cette fonction. Tout objet créé mais pas supprimé dans le métafichier amélioré est supprimé par cette fonction. Pour désactiver cette fonction, une application peut appeler la fonction Windows de CancelDC d'un autre thread pour terminer l'opération. Dans ce cas, retourne zéro de la fonction.
Configuration requise
Header: afxwin.h