PlayMetaFile-Funktion (wingdi.h)

Die Funktion PlayMetaFile zeigt das Bild an, das in der angegebenen Metadatei im Windows-Format auf dem angegebenen Gerät gespeichert ist.

Hinweis Diese Funktion wird nur zur Kompatibilität mit Metadateien im Windows-Format bereitgestellt. Metadateien im erweiterten Format bieten überlegene Funktionen und werden für neue Anwendungen empfohlen. Die entsprechende Funktion für eine Metadatei im erweiterten Format ist PlayEnhMetaFile.

 

Syntax

BOOL PlayMetaFile(
  [in] HDC       hdc,
  [in] HMETAFILE hmf
);

Parameter

[in] hdc

Handle für einen Gerätekontext.

[in] hmf

Handle für eine Metadatei im Windows-Format.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Verwenden Sie die Funktion SetWinMetaFileBits , um eine Metadatei im Windows-Format in eine Metadatei im erweiterten Format zu konvertieren.

Eine Metadatei im Windows-Format kann mehrmals wiedergegeben werden.

Eine Metadatei im Windows-Format kann in eine zweite Metadatei im Windows-Format eingebettet werden, indem die PlayMetaFile-Funktion aufgerufen und die Quellmetadatei im Gerätekontext für die Zielmetadatei wiedergegeben wird.

Jedes Objekt, das in der Metadatei im Windows-Format erstellt, aber nicht gelöscht wurde, wird 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.

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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

CancelDC

Metafilefunktionen

Übersicht über Metadateien

SetWinMetaFileBits