Fungsi CreateCompatibleBitmap (wingdi.h)

Artikel
03/08/2023

Fungsi CreateCompatibleBitmap membuat bitmap yang kompatibel dengan perangkat yang terkait dengan konteks perangkat yang ditentukan.

Sintaks

HBITMAP CreateCompatibleBitmap(
  [in] HDC hdc,
  [in] int cx,
  [in] int cy
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] cx

Lebar bitmap, dalam piksel.

[in] cy

Tinggi bitmap, dalam piksel.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke bitmap yang kompatibel (DDB).

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Format warna bitmap yang dibuat oleh fungsi CreateCompatibleBitmap cocok dengan format warna perangkat yang diidentifikasi oleh parameter hdc . Bitmap ini dapat dipilih ke dalam konteks perangkat memori apa pun yang kompatibel dengan perangkat asli.

Karena konteks perangkat memori memungkinkan bitmap warna dan monokrom, format bitmap yang dikembalikan oleh fungsi CreateCompatibleBitmap berbeda ketika konteks perangkat yang ditentukan adalah konteks perangkat memori. Namun, bitmap kompatibel yang dibuat untuk konteks perangkat nonmemory selalu memiliki format warna yang sama dan menggunakan palet warna yang sama dengan konteks perangkat yang ditentukan.

Catatan: Saat konteks perangkat memori dibuat, awalnya memiliki bitmap monokrom 1-by-1 yang dipilih ke dalamnya. Jika konteks perangkat memori ini digunakan dalam CreateCompatibleBitmap, bitmap yang dibuat adalah bitmap monokrom . Untuk membuat bitmap warna, gunakan HDC yang digunakan untuk membuat konteks perangkat memori, seperti yang ditunjukkan dalam kode berikut:


    HDC memDC = CreateCompatibleDC ( hDC );
    HBITMAP memBM = CreateCompatibleBitmap ( hDC, nWidth, nHeight );
    SelectObject ( memDC, memBM );

Jika aplikasi mengatur parameter nWidth atau nHeight ke nol, CreateCompatibleBitmap mengembalikan handel ke piksel 1 demi 1, bitmap monokrom.

Jika bagian DIB, yang merupakan bitmap yang dibuat oleh fungsi CreateDIBSection , dipilih ke dalam konteks perangkat yang diidentifikasi oleh parameter hdc , CreateCompatibleBitmap membuat bagian DIB.

Saat Anda tidak lagi memerlukan bitmap, panggil fungsi DeleteObject untuk menghapusnya.

Contoh

Misalnya, lihat Menskalakan 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