CreatePatternBrush
The CreatePatternBrush
function creates a logical brush with the specified bitmap pattern. The bitmap
cannot be a DIB section bitmap, which is created by the CreateDIBSection function.
HBRUSH CreatePatternBrush(
|
HBITMAP hbmp |
// handle to bitmap
|
|
); |
|
Parameters
hbmp
Identifies
the bitmap to be used to create the logical brush.
Windows 95:
Creating brushes from bitmaps or DIBs larger than 8x8 pixels is not supported.
If a larger bitmap is specified, only a portion of the bitmap is used.
Return Values
If the
function succeeds, the return value identifies a logical brush.
If the
function fails, the return value is NULL.
Remarks
A pattern
brush is a bitmap that Windows 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.
The bitmap
identified by hbmp cannot be a DIB section, which is a bitmap created by
the CreateDIBSection function. If the bitmap is a DIB section, the CreatePatternBrush
function fails.
See Also