CreateHatchBrush
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