Fungsi CreateCompatibleDC (wingdi.h)

Artikel
03/04/2024

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