CreatePatternBrush
A version of this page is also available for
4/8/2010
This function creates a logical brush with the specified bitmap pattern.
Syntax
HBRUSH CreatePatternBrush(
HBITMAP hbmp
);
Parameters
- hbmp
[in] Handle to the bitmap to be used to create the logical brush.
Return Value
A handle that identifies a logical brush indicates success. NULL indicates failure. To get extended error information, call GetLastError.
Remarks
A pattern brush is a bitmap of arbitrary size that the system uses to paint the interiors of filled shapes.
After an application creates a brush by calling CreatePatternBrush, it can select that brush into any device context by calling the SelectObject function.
You can delete a pattern brush without affecting the associated bitmap by using the DeleteObject function. Therefore, you can then use this bitmap to create any number of pattern brushes.
A brush created by using a monochrome (1 bit per pixel) bitmap has the text and background colors of the device context to which it is drawn.
Pixels represented by a 0 bit are drawn with the current text color; pixels represented by a 1 bit are drawn with the current background color.
Requirements
| Header | windows.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |