CreateDIBPatternBrushPt

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function creates a logical brush that has the pattern specified by the device-independent bitmap (DIB).

HBRUSH
CreateDIBPatternBrushPt( const
void
*
lpPackedDIB
, UINT
iUsage
);

Parameters

lpPackedDIB

[in] Long pointer to a packed DIB consisting of a BITMAPINFOstructure immediately followed by an array of bytes defining the pixels of the bitmap.

iUsage

[in] Specifies whether the bmiColorsmember of the BITMAPINFOstructure contains a valid color table and, if so, whether the entries in this color table contain explicit red, green, blue (RGB) values or palette indices. The iUsageparameter must be one of the following values.

Value	Description
DIB_PAL_COLORS	A color table is provided and consists of an array of 16-bit indices into the logical palette of the device context into which the brush is to be selected. Windows CE versions 1.0 and 1.01 do not support this value.
DIB_RGB_COLORS	A color table is provided and contains literal RGB values.

In Windows CE versions 2.0 and later, set the iUsageparameter to DIB_RGB_COLORS. When an 8 bpp bitmap is used, you can set iUsageto DIB_PAL_COLORS, however, in that case, Windows CE will ignore the values in the bmiColorsarray member of the BITMAPINFOstructure.

Return Values

Handle to a logical brush indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

A brush is a bitmap that the system uses to paint the interiors of filled shapes.

After an application creates a brush by calling CreateDIBPatternBrushPt, it can select that brush into any device context by calling the SelectObjectfunction.

When you no longer need the brush, call the DeleteObjectfunction to delete it.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Wingdi.h		Mgdraw.lib

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.