Fungsi CreateCompatibleBitmap (wingdi.h)
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk