Fungsi CreateCompatibleDC (wingdi.h)
Fungsi CreateCompatibleDC membuat konteks perangkat memori (DC) yang kompatibel dengan perangkat yang ditentukan.
Sintaks
HDC CreateCompatibleDC(
[in] HDC hdc
);
Parameter
[in] hdc
Handel ke DC yang ada. Jika handel ini NULL, fungsi membuat DC memori yang kompatibel dengan layar aplikasi saat ini.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke DC memori.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL.
Keterangan
DC memori hanya ada dalam memori. Ketika DC memori dibuat, permukaan tampilannya tepat satu piksel monokrom lebar dan satu piksel monokrom tinggi. Sebelum aplikasi dapat menggunakan DC memori untuk operasi menggambar, aplikasi harus memilih bitmap dengan lebar dan tinggi yang benar ke DC. Untuk memilih bitmap ke DC, gunakan fungsi CreateCompatibleBitmap , menentukan tinggi, lebar, dan organisasi warna yang diperlukan.
Saat DC memori dibuat, semua atribut diatur ke nilai default normal. DC memori dapat digunakan sebagai DC normal. Anda dapat mengatur atribut; mendapatkan pengaturan atributnya saat ini; dan pilih pena, kuas, dan wilayah.
Fungsi CreateCompatibleDC hanya dapat digunakan dengan perangkat yang mendukung operasi raster. Aplikasi dapat menentukan apakah perangkat mendukung operasi ini dengan memanggil fungsi GetDeviceCaps .
Ketika Anda tidak lagi memerlukan DC memori, panggil fungsi DeleteDC . Kami menyarankan agar Anda memanggil DeleteDC untuk menghapus DC. Namun, Anda juga dapat memanggil DeleteObject dengan HDC untuk menghapus DC.
Jika hdcadalah NULL, utas yang memanggil CreateCompatibleDC memiliki HDC yang dibuat. Ketika utas ini dihancurkan, HDC tidak lagi valid. Dengan demikian, jika Anda membuat HDC dan meneruskannya ke utas lain, maka keluar dari utas pertama, utas kedua tidak akan dapat menggunakan HDC.
ICM: Jika DC yang diteruskan ke fungsi ini diaktifkan untuk Manajemen Warna Gambar (ICM), DC yang dibuat oleh fungsi diaktifkan ICM. Ruang warna sumber dan tujuan ditentukan dalam DC.
Contoh
Misalnya, lihat Menangkap Gambar.
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 |