Fungsi PlayEnhMetaFile (wingdi.h)

Artikel
08/27/2023

Fungsi PlayEnhMetaFile menampilkan gambar yang disimpan dalam metafile format yang disempurnakan yang ditentukan.

Sintaks

BOOL PlayEnhMetaFile(
  [in] HDC          hdc,
  [in] HENHMETAFILE hmf,
  [in] const RECT   *lprect
);

Parameter

[in] hdc

Handel ke konteks perangkat untuk perangkat output tempat gambar akan muncul.

[in] hmf

Handel ke metafile yang ditingkatkan.

[in] lprect

Penunjuk ke struktur RECT yang berisi koordinat persegi panjang pembatas yang digunakan untuk menampilkan gambar. Koordinat ditentukan dalam unit logis.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Ketika aplikasi memanggil fungsi PlayEnhMetaFile , sistem menggunakan bingkai gambar di header enhanced-metafile untuk memetakan gambar ke persegi yang diarahkan oleh parameter lpRect . (Gambar ini dapat dikursi atau diputar dengan mengatur transformasi dunia di perangkat output sebelum memanggil PlayEnhMetaFile.) Titik di sepanjang tepi persegi disertakan dalam gambar.

Gambar metafile yang disempurnakan dapat diklip dengan menentukan wilayah kliping di perangkat output sebelum memutar metafile yang disempurnakan.

Jika metafile yang disempurnakan berisi palet opsional, aplikasi dapat mencapai warna yang konsisten dengan menyiapkan palet warna pada perangkat output sebelum memanggil PlayEnhMetaFile. Untuk mengambil palet opsional, gunakan fungsi GetEnhMetaFilePaletteEntries .

Metafile yang disempurnakan dapat disematkan dalam metafile yang baru dibuat dengan memanggil PlayEnhMetaFile dan memutar metafile sumber yang ditingkatkan ke dalam konteks perangkat untuk metafile baru yang ditingkatkan.

Status konteks perangkat output dipertahankan oleh fungsi ini. Objek apa pun yang dibuat tetapi tidak dihapus dalam metafile yang ditingkatkan 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.

Contoh

Misalnya, lihat Membuka Metafile yang Ditingkatkan dan Menampilkan Kontennya.

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