struttura LOGBRUSH32 (wingdi.h)

La struttura LOGBRUSH32 definisce lo stile, il colore e il motivo di un pennello fisico. È simile a LOGBRUSH, ma viene usato per mantenere la compatibilità tra piattaforme a 32 bit e piattaforme a 64 bit quando si registra il record metafile in una piattaforma e quindi lo si riproduce su un'altra. Pertanto, viene usato solo in EMRCREATEBRUSHINDIRECT. Se il codice sarà in una sola piattaforma, LOGBRUSH è sufficiente.

Sintassi

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

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 Uguale a 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 Uguale a 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.

I pennelli possono essere creati da bitmap o DIB superiori a 8 per 8 pixel.

Requisiti

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

Vedi anche

BITMAPINFO

Strutture pennello

Panoramica dei pennelli

COLORREF

CreateDIBSection

EMRCREATEBRUSHINDIRECT

LOGBRUSH

RGB

SetBkColor

SetBkMode