Fungsi CreateDIBPatternBrush (wingdi.h)

Artikel
03/13/2024

Fungsi CreateDIBPatternBrush membuat kuas logis yang memiliki pola yang ditentukan oleh bitmap independen perangkat (DIB) yang ditentukan. Kuas kemudian dapat dipilih ke dalam konteks perangkat apa pun yang terkait dengan perangkat yang mendukung operasi raster.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit. Aplikasi harus menggunakan fungsi CreateDIBPatternBrushPt .

Sintaks

HBRUSH CreateDIBPatternBrush(
  [in] HGLOBAL h,
  [in] UINT    iUsage
);

Parameter

[in] h

Handel ke objek memori global yang berisi DIB yang dikemas, yang terdiri dari struktur BITMAPINFO segera diikuti oleh array byte yang menentukan piksel bitmap.

[in] iUsage

Menentukan apakah anggota bmiColors dari struktur BITMAPINFO diinisialisasi dan, jika demikian, apakah anggota ini berisi nilai atau indeks merah, hijau, biru (RGB) eksplisit ke dalam palet logis. Parameter fuColorSpec harus menjadi salah satu nilai berikut.

Nilai	Makna
DIB_PAL_COLORS	Tabel warna disediakan dan terdiri dari array indeks 16-bit ke dalam palet logis konteks perangkat tempat kuas akan dipilih.
DIB_RGB_COLORS	Tabel warna disediakan dan berisi nilai RGB harfiah.

Nilai kembali

Jika fungsi berhasil, nilai pengembalian mengidentifikasi kuas logis.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Ketika aplikasi memilih kuas pola DIB dua warna ke dalam konteks perangkat monokrom, sistem tidak mengakui warna yang ditentukan dalam DIB; sebaliknya, ia menampilkan kuas pola menggunakan latar belakang saat ini dan warna latar depan dari konteks perangkat. Piksel yang dipetakan ke warna pertama DIB (offset 0 dalam tabel warna DIB) ditampilkan menggunakan warna latar depan; piksel yang dipetakan ke warna kedua (offset 1 dalam tabel warna) ditampilkan menggunakan warna latar belakang.

Ketika Anda tidak lagi memerlukan kuas, panggil fungsi DeleteObject untuk menghapusnya.

ICM: Tidak ada warna yang dilakukan pada pembuatan kuas. Namun, manajemen warna dilakukan ketika kuas dipilih ke dalam konteks perangkat berkemampuan ICM.

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