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;
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 and Windows 98: 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. |
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. |
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.
Although lbColor controls the foreground color of a hatch brush, the SetBkMode and SetBkColor functions control the background color.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Requires version 1.0 or later.
Header: Declared in wingdi.h.
Brushes Overview, Brush Structures, BITMAPINFO, CreateBrushIndirect, CreateDIBSection, ExtCreatePen, SetBkColor, SetBkMode