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
);
| 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 |
If the function succeeds, the return value identifies a logical brush.
If the function fails, the return value is NULL.
Windows NT: To get extended error information, call GetLastError.
A brush is a bitmap that the system 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.
ICM: No color is done at brush creation. However, color management will be performed when the brush is selected into an ICM-enabled device context.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in wingdi.h.
Import Library: Use gdi32.lib.
Brushes Overview, Brush Functions, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreatePatternBrush, CreateSolidBrush, DeleteObject, GetBrushOrgEx, SelectObject, SetBrushOrgEx