Struttura LOGBRUSH (wingdi.h)

Articolo
08/27/2023

La struttura LOGBRUSH definisce lo stile, il colore e il motivo di un pennello fisico. Viene usato dalle funzioni CreateBrushIndirect e ExtCreatePen .

Sintassi

typedef struct tagLOGBRUSH {
  UINT      lbStyle;
  COLORREF  lbColor;
  ULONG_PTR lbHatch;
} LOGBRUSH, *PLOGBRUSH, *NPLOGBRUSH, *LPLOGBRUSH;

Members

lbStyle

Stile del pennello. Il membro lbStyle deve essere uno degli stili seguenti.

Valore	Significato
BS_DIBPATTERN	Pennello modello definito da una specifica DIB (Device-Independent Bitmap). Se lbStyle è BS_DIBPATTERN, il membro lbHatch contiene un handle per un DIB compresso. Per altre informazioni, vedere discussione in lbHatch.
BS_DIBPATTERN8X8	Vedere BS_DIBPATTERN.
BS_DIBPATTERNPT	Pennello modello definito da una specifica DIB (Device-Independent Bitmap). Se lbStyle è BS_DIBPATTERNPT, il membro lbHatch contiene un puntatore a un DIB compresso. Per altre informazioni, vedere discussione in lbHatch.
BS_HATCHED	Pennello tratteggio.
BS_HOLLOW	Pennello vuoto.
BS_NULL	Uguale a BS_HOLLOW.
BS_PATTERN	Pennello modello definito da una bitmap di memoria.
BS_PATTERN8X8	Vedere BS_PATTERN.
BS_SOLID	Pennello a tinta unita.

lbColor

Colore in cui deve essere disegnato il pennello. Se lbStyle è lo stile BS_HOLLOW o BS_PATTERN, lbColor viene ignorato.

Se lbStyle è BS_DIBPATTERN o BS_DIBPATTERNPT, la parola con ordine basso di lbColor specifica se i membri bmiColors della struttura BITMAPINFO contengono valori espliciti rosso, verde, blu (RGB) o indici nella tavolozza logica attualmente realizzata. Il membro lbColor deve essere uno dei valori seguenti.

Valore	Significato
DIB_PAL_COLORS	La tabella dei colori è costituita da una matrice di indici a 16 bit nella tavolozza logica attualmente realizzata.
DIB_RGB_COLORS	La tabella dei colori contiene valori RGB letterali.

Se lbStyle è BS_HATCHED o BS_SOLID, lbColor è un valore di colore COLORREF . Per creare un valore di colore COLORREF , utilizzare la macro RGB .

lbHatch

Stile tratteggio. Il significato dipende dallo stile del pennello definito da lbStyle.

Se lbStyle è BS_DIBPATTERN, il membro lbHatch contiene un handle per un DIB compresso. Per ottenere questo handle, un'applicazione chiama la funzione GlobalAlloc con GMEM_MOVEABLE (o LocalAlloc con LMEM_MOVEABLE) per allocare un blocco di memoria e quindi riempie la memoria con il diB compresso. Un DIB compresso è costituito da una struttura BITMAPINFO immediatamente seguita dalla matrice di byte che definiscono i pixel della bitmap.

Se lbStyle è BS_DIBPATTERNPT, il membro lbHatch contiene un puntatore a un DIB compresso. Il puntatore deriva dal blocco di memoria creato da LocalAlloc con LMEM_FIXED impostato o da GlobalAlloc con GMEM_FIXED impostato oppure è il puntatore restituito da una chiamata come LocalLock (handle_to_the_dib). Un DIB compresso è costituito da una struttura BITMAPINFO immediatamente seguita dalla matrice di byte che definiscono i pixel della bitmap.

Se lbStyle è BS_HATCHED, il membro lbHatch specifica l'orientamento delle linee utilizzate per creare il tratteggio. Può essere uno dei valori seguenti.

Valore	Significato
HS_BDIAGONAL	Un tratteggio da 45 gradi verso l'alto, da sinistra a destra
HS_CROSS	Tratteggio orizzontale e verticale
HS_DIAGCROSS	Crosshatch a 45 gradi
HS_FDIAGONAL	Un tratteggio da 45 gradi verso il basso, da sinistra a destra
HS_HORIZONTAL	Tratteggio orizzontale
HS_VERTICAL	Tratteggio verticale

Se lbStyle è BS_PATTERN, lbHatch è un handle per la bitmap che definisce il modello. La bitmap non può essere una bitmap di sezione DIB, creata dalla funzione CreateDIBSection .

Se lbStyle è BS_SOLID o BS_HOLLOW, lbHatch viene ignorato.

Commenti

Sebbene lbColor controlli il colore di primo piano di un pennello di tratteggio, le funzioni SetBkMode e SetBkColor controllano il colore di sfondo.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	wingdi.h (include Windows.h)