struktur LOGBRUSH32 (wingdi.h)

Artikel
03/08/2023

Struktur LOGBRUSH32 mendefinisikan gaya, warna, dan pola kuas fisik. Ini mirip dengan LOGBRUSH, tetapi digunakan untuk menjaga kompatibilitas antara platform 32-bit dan platform 64-bit ketika kita merekam rekaman metafile pada satu platform dan kemudian memutarnya di platform lain. Dengan demikian, ini hanya digunakan dalam EMRCREATEBRUSHINDIRECT. Jika kode hanya akan berada di satu platform, LOGBRUSH sudah cukup.

Sintaks

typedef struct tagLOGBRUSH32 {
  UINT     lbStyle;
  COLORREF lbColor;
  ULONG    lbHatch;
} LOGBRUSH32, *PLOGBRUSH32, *NPLOGBRUSH32, *LPLOGBRUSH32;

Anggota

lbStyle

Gaya kuas. Anggota lbStyle harus salah satu gaya berikut.

Nilai	Makna
BS_DIBPATTERN	Kuas pola yang ditentukan oleh spesifikasi bitmap independen perangkat (DIB). Jika lbStyle BS_DIBPATTERN, anggota lbHatch berisi handel ke DIB yang dikemas. Untuk informasi selengkapnya, lihat diskusi di lbHatch.
BS_DIBPATTERN8X8	Sama seperti BS_DIBPATTERN.
BS_DIBPATTERNPT	Kuas pola yang ditentukan oleh spesifikasi bitmap independen perangkat (DIB). Jika lbStyle BS_DIBPATTERNPT, anggota lbHatch berisi pointer ke DIB yang dikemas. Untuk informasi selengkapnya, lihat diskusi di lbHatch.
BS_HATCHED	Sikat menetas.
BS_HOLLOW	Kuas berongga.
BS_NULL	Sama seperti BS_HOLLOW.
BS_PATTERN	Kuas pola didefinisikan oleh bitmap memori.
BS_PATTERN8X8	Sama seperti BS_PATTERN.
BS_SOLID	Kuas padat.

lbColor

Warna di mana kuas akan digambar. Jika lbStyle adalah gaya BS_HOLLOW atau BS_PATTERN, lbColor diabaikan.

Jika lbStyle BS_DIBPATTERN atau BS_DIBPATTERNPT, kata urutan rendah lbColor menentukan apakah anggota bmiColors dari struktur BITMAPINFO berisi nilai atau indeks merah, hijau, biru (RGB) eksplisit ke dalam palet logis yang saat ini direalisasikan. Anggota lbColor harus menjadi salah satu nilai berikut.

Nilai	Makna
DIB_PAL_COLORS	Tabel warna terdiri dari array indeks 16-bit ke dalam palet logika yang saat ini diwujudkan.
DIB_RGB_COLORS	Tabel warna berisi nilai RGB harfiah.

Jika lbStyle BS_HATCHED atau BS_SOLID, lbColor adalah nilai warna COLORREF . Untuk membuat nilai warna COLORREF , gunakan makro RGB .

lbHatch

Gaya menetas. Maknanya tergantung pada gaya kuas yang didefinisikan oleh lbStyle.

Jika lbStyle BS_DIBPATTERN, anggota lbHatch berisi handel ke DIB yang dikemas. Untuk mendapatkan handel ini, aplikasi memanggil fungsi GlobalAlloc dengan GMEM_MOVEABLE (atau LocalAlloc dengan LMEM_MOVEABLE) untuk mengalokasikan blok memori dan kemudian mengisi memori dengan DIB yang dikemas. DIB yang dikemas terdiri dari struktur BITMAPINFO segera diikuti oleh array byte yang menentukan piksel bitmap.

Jika lbStyle BS_DIBPATTERNPT, anggota lbHatch berisi pointer ke DIB yang dikemas. Penunjuk berasal dari blok memori yang dibuat oleh LocalAlloc dengan LMEM_FIXED diatur atau oleh GlobalAlloc dengan set GMEM_FIXED, atau itu adalah penunjuk yang dikembalikan oleh panggilan seperti LocalLock (handle_to_the_dib). DIB yang dikemas terdiri dari struktur BITMAPINFO segera diikuti oleh array byte yang menentukan piksel bitmap.

Jika lbStyle BS_HATCHED, anggota lbHatch menentukan orientasi baris yang digunakan untuk membuat hatch. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
HS_BDIAGONAL	Menetas 45 derajat ke atas, kiri-ke-kanan
HS_CROSS	Menetas silang horizontal dan vertikal
HS_DIAGCROSS	Crosshatch 45 derajat
HS_FDIAGONAL	Menetas 45 derajat ke bawah, kiri-ke-kanan
HS_HORIZONTAL	Menetas horizontal
HS_VERTICAL	Menetas vertikal

Jika lbStyle BS_PATTERN, lbHatch adalah handel ke bitmap yang menentukan pola. Bitmap tidak dapat menjadi bitmap bagian DIB, yang dibuat oleh fungsi CreateDIBSection .

Jika lbStyle BS_SOLID atau BS_HOLLOW, lbHatch diabaikan.

Keterangan

Meskipun lbColor mengontrol warna latar depan kuas hatch, fungsi SetBkMode dan SetBkColor mengontrol warna latar belakang.

Kuas dapat dibuat dari bitmap atau DIB yang lebih besar dari 8 dengan 8 piksel.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	wingdi.h (sertakan Windows.h)