Fungsi CreateEnhMetaFileA (wingdi.h)

Fungsi CreateEnhMetaFile membuat konteks perangkat untuk metafile format yang disempurnakan. Konteks perangkat ini dapat digunakan untuk menyimpan gambar independen perangkat.

Sintaksis

HDC CreateEnhMetaFileA(
  [in] HDC        hdc,
  [in] LPCSTR     lpFilename,
  [in] const RECT *lprc,
  [in] LPCSTR     lpDesc
);

Parameter

[in] hdc

Handel ke perangkat referensi untuk metafile yang ditingkatkan. Parameter ini dapat NULL ; untuk informasi selengkapnya, lihat Keterangan.

[in] lpFilename

Penunjuk ke nama file untuk metafile yang ditingkatkan yang akan dibuat. Jika parameter ini NULL, metafile yang ditingkatkan berbasis memori dan kontennya hilang ketika dihapus dengan menggunakan fungsi DeleteEnhMetaFile.

[in] lprc

Penunjuk ke struktur RECT yang menentukan dimensi (dalam unit .01-milimeter) gambar yang akan disimpan dalam metafile yang disempurnakan.

[in] lpDesc

Penunjuk ke string yang menentukan nama aplikasi yang membuat gambar, serta judul gambar. Parameter ini dapat NULL ; untuk informasi selengkapnya, lihat Keterangan.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah handel ke konteks perangkat untuk metafile yang ditingkatkan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Komentar

Di mana argumen teks harus menggunakan karakter Unicode, gunakan fungsi CreateEnhMetaFile sebagai fungsi karakter lebar. Di mana argumen teks harus menggunakan karakter dari set karakter Windows, gunakan fungsi ini sebagai fungsi ANSI.

Sistem menggunakan perangkat referensi yang diidentifikasi oleh parameter hdcRef untuk merekam resolusi dan unit perangkat tempat gambar awalnya muncul. Jika parameter hdcRef NULL, parameter tersebut menggunakan perangkat tampilan saat ini untuk referensi.

kiri dan anggota atas struktur RECT yang ditunjukkan oleh parameter lpRect harus kurang dari kanan dan anggota bawah . Titik di sepanjang tepi persegi disertakan dalam gambar. Jika lpRectNULL, antarmuka perangkat grafis (GDI) menghitung dimensi persegi panjang terkecil yang mengelilingi gambar yang digambar oleh aplikasi. Parameter lpRect harus disediakan jika memungkinkan.

String yang ditunjukkan oleh parameter lpDescription harus berisi karakter null antara nama aplikasi dan nama gambar dan harus dihentikan dengan dua karakter null, misalnya, "XYZ Graphics Editor\0Bald Eagle\0\0", di mana \0 mewakili karakter null. Jika lpDescription NULL, tidak ada entri yang sesuai di header enhanced-metafile.

Aplikasi menggunakan konteks perangkat yang dibuat oleh fungsi ini untuk menyimpan gambar grafis dalam metafile yang disempurnakan. Handel yang mengidentifikasi konteks perangkat ini dapat diteruskan ke fungsi GDI apa pun.

Setelah aplikasi menyimpan gambar dalam metafile yang ditingkatkan, aplikasi dapat menampilkan gambar pada perangkat output apa pun dengan memanggil fungsi PlayEnhMetaFile . Saat menampilkan gambar, sistem menggunakan persegi yang ditujukkan oleh parameter lpRect dan data resolusi dari perangkat referensi ke posisi dan skala gambar.

Konteks perangkat yang dikembalikan oleh fungsi ini berisi atribut default yang sama yang terkait dengan konteks perangkat baru apa pun.

Aplikasi harus menggunakan fungsi GetWinMetaFileBits untuk mengonversi metafile yang ditingkatkan ke format metafile Windows yang lebih lama.

Nama file untuk metafile yang ditingkatkan harus menggunakan ekstensi .emf.

Contoh

Misalnya, lihat MembuatMetafile yang Ditingkatkan .

Catatan

Header wingdi.h mendefinisikan CreateEnhMetaFile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wingdi.h (termasuk Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

CloseEnhMetaFile

DeleteEnhMetaFile

GetEnhMetaFileDescription

GetEnhMetaFileHeader

GetWinMetaFileBits

Metafile Functions

Gambaran Umum Metafiles

PlayEnhMetaFile

RECT