Fungsi PlayMetaFile (wingdi.h)

Artikel
03/08/2023

Fungsi PlayMetaFile menampilkan gambar yang disimpan dalam metafile format Windows yang diberikan pada perangkat yang ditentukan.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan metafil format Windows. Metafil format yang disempurnakan menyediakan fungsionalitas yang unggul dan direkomendasikan untuk aplikasi baru. Fungsi yang sesuai untuk metafile format yang disempurnakan adalah PlayEnhMetaFile.

Sintaks

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

Parameter

[in] hdc

Menangani konteks perangkat.

[in] hmf

Menangani metafile format Windows.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Untuk mengonversi metafile format Windows menjadi metafile format yang disempurnakan, gunakan fungsi SetWinMetaFileBits .

Metafile format Windows dapat diputar beberapa kali.

Metafile format Windows dapat disematkan dalam metafile format Windows kedua dengan memanggil fungsi PlayMetaFile dan memutar metafile sumber ke dalam konteks perangkat untuk metafile target.

Objek apa pun yang dibuat tetapi tidak dihapus dalam metafile format Windows dihapus oleh fungsi ini.

Untuk menghentikan fungsi ini, aplikasi dapat memanggil fungsi CancelDC dari utas lain untuk mengakhiri operasi. Dalam hal ini, fungsi mengembalikan FALSE.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

CancelDC

Fungsi Metafile

Gambaran Umum Metafiles

SetWinMetaFileBits

Bagikan melalui