Fungsi CreateEnhMetaFileA (wingdi.h)
Fungsi CreateEnhMetaFile membuat konteks perangkat untuk metafile format yang disempurnakan. Konteks perangkat ini dapat digunakan untuk menyimpan gambar independen perangkat.
Sintaks
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 disempurnakan. Parameter ini bisa 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 bisa NULL; untuk informasi selengkapnya, lihat Keterangan.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke konteks perangkat untuk metafile yang disempurnakan.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL.
Keterangan
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 adalah NULL, parameter tersebut menggunakan perangkat tampilan saat ini untuk referensi.
Anggota kiri dan atas struktur RECT yang ditujukkan oleh parameter lpRect masing-masing harus kurang dari anggota kanan dan bawah . Titik-titik di sepanjang tepi persegi panjang disertakan dalam gambar. Jika lpRect adalah NULL, antarmuka perangkat grafis (GDI) menghitung dimensi persegi 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, "Grafik XYZ Editor\0Bald Eagle\0\0", di mana \0 mewakili karakter null. Jika lpDescription adalah 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 disempurnakan, aplikasi dapat menampilkan gambar pada perangkat output apa pun dengan memanggil fungsi PlayEnhMetaFile . Saat menampilkan gambar, sistem menggunakan persegi panjang yang diacu oleh parameter lpRect dan data resolusi dari perangkat referensi untuk memposisikan dan menskalakan gambar.
Konteks perangkat yang dikembalikan oleh fungsi ini berisi atribut default yang sama yang terkait dengan konteks perangkat baru.
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 Membuat Metafile 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
| 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 |