PlayEnhMetaFile-Funktion (wingdi.h)
Die PlayEnhMetaFile-Funktion zeigt das Bild an, das in der angegebenen Metadatei des erweiterten Formats gespeichert ist.
Syntax
BOOL PlayEnhMetaFile(
[in] HDC hdc,
[in] HENHMETAFILE hmf,
[in] const RECT *lprect
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext für das Ausgabegerät, auf dem das Bild angezeigt wird.
[in] hmf
Ein Handle für die erweiterte Metadatei.
[in] lprect
Ein Zeiger auf eine RECT-Struktur , die die Koordinaten des begrenzungsenden Rechtecks enthält, mit dem das Bild angezeigt wird. Die Koordinaten werden in logischen Einheiten angegeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Wenn eine Anwendung die PlayEnhMetaFile-Funktion aufruft, verwendet das System den Bildrahmen im header enhanced-metafile, um das Bild dem Rechteck zuzuordnen, auf das der lpRect-Parameter verweist. (Dieses Bild kann durch Festlegen der Welttransformation im Ausgabegerät vor dem Aufrufen von PlayEnhMetaFile verworren oder gedreht werden.) Punkte entlang der Kanten des Rechtecks sind im Bild enthalten.
Ein Bild der erweiterten Metadatei kann abgeschnitten werden, indem der Beschneidungsbereich auf dem Ausgabegerät definiert wird, bevor die erweiterte Metadatei wiedergegeben wird.
Wenn eine erweiterte Metadatei eine optionale Palette enthält, kann eine Anwendung konsistente Farben erzielen, indem eine Farbpalette auf dem Ausgabegerät eingerichtet wird, bevor PlayEnhMetaFile aufgerufen wird. Verwenden Sie zum Abrufen der optionalen Palette die GetEnhMetaFilePaletteEntries-Funktion .
Eine erweiterte Metadatei kann in eine neu erstellte erweiterte Metadatei eingebettet werden, indem Sie PlayEnhMetaFile aufrufen und die erweiterte Metadatei der Quelle im Gerätekontext für die neue erweiterte Metadatei wiedergeben.
Die Zustände des Ausgabegerätekontexts werden von dieser Funktion beibehalten. Alle Objekte, die in der erweiterten Metadatei erstellt, aber nicht gelöscht wurden, werden von dieser Funktion gelöscht.
Um diese Funktion zu beenden, kann eine Anwendung die CancelDC-Funktion aus einem anderen Thread aufrufen, um den Vorgang zu beenden. In diesem Fall gibt die Funktion FALSE zurück.
Beispiele
Ein Beispiel finden Sie unter Öffnen einer erweiterten Metadatei und Anzeigen ihres Inhalts.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (einschließlich Windows.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |