PlayEnhMetaFile-Funktion (wingdi.h)

Artikel
08/27/2023

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