CDC::PlayMetaFile
Gibt den Inhalt der angegebenen Metadatei auf dem Gerätekontext erneut.
BOOL PlayMetaFile(
HMETAFILE hMF
);
BOOL PlayMetaFile(
HENHMETAFILE hEnhMetaFile,
LPCRECT lpBounds
);
Parameter
hMF
Identifiziert die wiedergegeben werden Metadatei.hEnhMetaFile
Identifiziert die erweiterte Metadatei.lpBounds
Zeigt auf RECT-Struktur oder ein CRect-Objekt, das die Koordinaten des umgebenden Rechtecks enthält, das verwendet wird, um das Bild anzuzeigen. Die Koordinaten werden in logischen Einheiten angegeben.
Rückgabewert
Ungleich 0 (null), wenn die Funktion erfolgreich; 0 andernfalls.
Hinweise
Der Metadatei kann beliebig oft wiederholt werden.
Die zweite Version von PlayMetaFile zeigt das Bild an, das in der angegebenen ErhöhenFormat Metadatei gespeichert wird. Wenn eine Anwendung die zweite Version von PlayMetaFile aufruft, verwendet Windows den Bilderrahmen im Header der erweiterten Metadatei, um das Bild auf das Rechteck zuzuordnen, das an den lpBounds-Parameter angezeigt wird. (Dieses Bild wird möglicherweise geschoren, oder gedreht, indem Sie die Welt festlegen, scheinen im Ausgabegerät, bevor Sie PlayMetaFile) aufrufen. Punkte an den Rändern des Rechtecks werden im Bild enthalten. Ein Bild der erweiterten Metadatei kann abgeschnitten werden, indem der Clippingbereich im Ausgabegerät definiert, bevor die erweiterte Metadatei wiedergibt.
Wenn eine erweiterte Metadatei eine optionale Palette enthält, kann eine Anwendung konsistente Farben erzielen, indem sie eine Farbpalette auf dem Ausgabegerät installiert, bevor die zweite Version von PlayMetaFile aufruft. Um die optionale Palette abzurufen, verwenden Sie die GetEnhMetaFilePaletteEntries Windows-Funktion. Eine erweiterte Metadatei kann in einer neu erstellten erweiterten Metadatei eingebettet werden, indem die zweite Version von PlayMetaFile aufruft und die Quellerweiterte metadatei in den Gerätekontext für die neue erweiterte Metadatei wiedergibt.
Die Zustände des Ausgabegerätekontexts werden von dieser Funktion beibehalten. Jedes Objekt, das erstellt wird, jedoch nicht in der erweiterten Metadatei gelöscht wird, wird von dieser Funktion gelöscht. Um diese Funktion zu beenden, kann eine Anwendung die CancelDC Windows-Funktion von einem anderen Thread aufrufen um den Vorgang zu beenden. In diesem Fall Funktionsrückgaben null.
Anforderungen
Header: afxwin.h