CreatePatternBrush

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

CreateDIBSection
DeleteObject
SelectObject
GDI Functions