Fungsi SetWinMetaFileBits (wingdi.h)

Artikel
03/04/2024

Fungsi SetWinMetaFileBits mengonversi metafile dari format Windows yang lebih lama ke format baru yang disempurnakan dan menyimpan metafile baru dalam memori.

Sintaks

HENHMETAFILE SetWinMetaFileBits(
  [in] UINT               nSize,
  [in] const BYTE         *lpMeta16Data,
  [in] HDC                hdcRef,
  [in] const METAFILEPICT *lpMFP
);

Parameter

[in] nSize

Ukuran, dalam byte, dari buffer yang berisi metafile format Windows.

[in] lpMeta16Data

Penunjuk ke buffer yang berisi data metafile format Windows. (Diasumsikan bahwa data diperoleh dengan menggunakan fungsi GetMetaFileBitsEx atau GetWinMetaFileBits .)

[in] hdcRef

Handel ke konteks perangkat referensi.

[in] lpMFP

Penunjuk ke struktur METAFILEPICT yang berisi ukuran gambar metafile yang disarankan dan mode pemetaan yang digunakan saat gambar dibuat.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke metafile yang ditingkatkan berbasis memori.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Windows menggunakan data resolusi konteks perangkat referensi dan data dalam struktur METAFILEPICT untuk menskalakan gambar. Jika parameter hdcRef adalah NULL, sistem menggunakan data resolusi untuk perangkat output saat ini. Jika parameter lpmfpadalah NULL, sistem menggunakan mode pemetaan MM_ANISOTROPIC untuk menskalakan gambar sehingga sesuai dengan seluruh permukaan perangkat. Anggota hMF dari struktur METAFILEPICT tidak digunakan.

Ketika aplikasi tidak lagi memerlukan handel metafile yang disempurnakan, aplikasi harus menghapusnya dengan memanggil fungsi DeleteEnhMetaFile .

Handel yang dikembalikan oleh fungsi ini dapat digunakan dengan fungsi enhanced-metafile lainnya.

Jika konteks perangkat referensi tidak identik dengan perangkat tempat metafile awalnya dibuat, beberapa fungsi GDI yang menggunakan unit perangkat mungkin tidak menggambar gambar dengan benar.

Persyaratan

Persyaratan	Nilai
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