Prev Next

LOGBRUSH info  Overview  Group

The LOGBRUSH structure defines the style, color, and pattern of a physical brush. It is used by the CreateBrushIndirect and ExtCreatePen functions.

typedef struct tagLOGBRUSH { // lb 

   UINT     lbStyle; 

   COLORREF lbColor; 

   LONG     lbHatch; 

} LOGBRUSH; 

 

Members

lbStyle
Specifies the brush style. The lbStyle member must be one of the following styles:

Value

Meaning

BS_DIBPATTERN

A pattern brush defined by a device-independent bitmap (DIB) specification. If lbStyle is BS_DIBPATTERN, the lbHatch member contains a handle to a packed DIB.

Windows 95: Creating brushes from bitmaps or DIBs larger than 8x8 pixels is not supported. If a larger bitmap is given, only a portion of the bitmap is used.

BS_DIBPATTERN8X8

Same as BS_DIBPATTERN.

BS_DIBPATTERNPT

A pattern brush defined by a device-independent bitmap (DIB) specification. If lbStyle is BS_DIBPATTERNPT, the lbHatch member contains a pointer to a packed DIB.

BS_HATCHED

Hatched brush.

BS_HOLLOW

Hollow brush.

BS_NULL

Same as BS_HOLLOW.

BS_PATTERN

Pattern brush defined by a memory bitmap.

BS_PATTERN8X8

Same as BS_PATTERN.

BS_SOLID

Solid brush.

lbColor
Specifies the color in which the brush is to be drawn. If lbStyle is the BS_HOLLOW or BS_PATTERN style, lbColor is ignored.

If lbStyle is BS_DIBPATTERN or BS_DIBPATTERNBT, the low-order word of lbColor specifies whether the bmiColors members of the BITMAPINFO structure contain explicit red, green, blue (RGB) values or indices into the currently realized logical palette. The lbColor member must be one of the following values:

Value

Meaning

DIB_PAL_COLORS

The color table consists of an array of 16-bit indices into the currently realized logical palette.

DIB_RGB_COLORS

The color table contains literal RGB values.

lbHatch
Specifies a hatch style. The meaning depends on the brush style defined by lbStyle.

If lbStyle is BS_DIBPATTERN, the lbHatch member contains a handle to a packed DIB. If lbStyle is BS_DIBPATTERNPT, the lbHatch member contains a pointer to a packed DIB.

If lbStyle is BS_HATCHED, the lbHatch member specifies the orientation of the lines used to create the hatch. It can be one of the following values:

Value

Meaning

HS_BDIAGONAL

A 45-degree upward, left-to-right hatch

HS_CROSS

Horizontal and vertical cross-hatch

HS_DIAGCROSS

45-degree crosshatch

HS_FDIAGONAL

A 45-degree downward, left-to-right hatch

HS_HORIZONTAL

Horizontal hatch

HS_VERTICAL

Vertical hatch

If lbStyle is BS_PATTERN, lbHatch is a handle to the bitmap that defines the pattern. The bitmap cannot be a DIB section bitmap, which is created by the CreateDIBSection function.

If lbStyle is BS_SOLID or BS_HOLLOW, lbHatch is ignored.

Remarks

Although lbColor controls the foreground color of a hatch brush, the SetBkMode and SetBkColor functions control the background color.

See Also

BITMAPINFO, CreateBrushIndirect, CreateDIBSection, ExtCreatePen, SetBkColor, SetBkMode