The CreateDIBPatternBrush function creates a logical brush that has the pattern specified by the specified device-independent bitmap (DIB). The brush can subsequently be selected into any device context that is associated with a device that supports raster operations.
Note This function is provided only for compatibility with applications written for 16-bit versions of Windows. For Win32-based applications, use the CreateDIBPatternBrushPt function.
HBRUSH CreateDIBPatternBrush(
HGLOBAL hglbDIBPacked, // handle to device-independent bitmap
UINT fuColorSpec // color table data
);
Windows 95 and Windows 98: 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.
Value | Meaning |
---|---|
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. |
DIB_RGB_COLORS | A color table is provided and contains literal RGB values. |
If the function succeeds, the return value identifies a logical brush.
If the function fails, the return value is NULL.
Windows NT: To get extended error information, call GetLastError.
When an application selects a two-color DIB pattern brush into a monochrome device context, the system does not acknowledge the colors specified in the DIB; instead, it displays the pattern brush using the current background and foreground colors of the device context. Pixels mapped to the first color of the DIB (offset 0 in the DIB color table) are displayed using the foreground color; pixels mapped to the second color (offset 1 in the color table) are displayed using the background color.
When you no longer need the brush, call the DeleteObject function to delete it.
ICM: No color is done at brush creation. However, color management will be performed when the brush is selected into an ICM-enabled device context.
Brushes Overview, Brush Functions, BITMAPINFO, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush, DeleteObject, SetBkColor, SetTextColor