The CreateHatchBrush function creates a logical brush that has the specified hatch pattern and color.
HBRUSH CreateHatchBrush(
| int fnStyle, | // hatch style |
| COLORREF clrref | // color value |
| ); |
Parameters
fnStyle
Specifies the hatch style of the brush. This parameter can be any one of the following values:
| Value | Meaning |
| HS_BDIAGONAL | 45-degree downward left-to-right hatch |
| HS_CROSS | Horizontal and vertical crosshatch |
| HS_DIAGCROSS | 45-degree crosshatch |
| HS_FDIAGONAL | 45-degree upward left-to-right hatch |
| HS_HORIZONTAL | Horizontal hatch |
| HS_VERTICAL | Vertical hatch |
clrref
Specifies the foreground color of the brush that is used for the hatches.
Return Values
If the function succeeds, the return value identifies a logical brush.
If the function fails, the return value is NULL.
Remarks
A brush is a bitmap that Windows uses to paint the interiors of filled shapes.
After an application creates a brush by calling CreateHatchBrush, it can select that brush into any device context by calling the SelectObject function.
If an application uses a hatch brush to fill the backgrounds of both a parent and a child window with matching color, it may be necessary to set the brush origin before painting the background of the child window. You can do this by having your application call the SetBrushOrgEx function. Your application can retrieve the current brush origin by calling the GetBrushOrgEx function.
When you no longer need the brush, call the DeleteObject function to delete it.
See Also
CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreatePatternBrush, CreateSolidBrush, DeleteObject, GetBrushOrgEx, SelectObject, SetBrushOrgEx