CreatePatternBrush

This function creates a logical brush with the specified bitmap pattern.

HBRUSH CreatePatternBrush( 
HBITMAP hbmp
);

Parameters

• hbmp
  [in] Handle to the bitmap to be used to create the logical brush.

Return Values

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, which can be of an 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

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CreateDibSection, DeleteObject, GetLastError, SelectObject

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.