CreateDIBPatternBrush
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.
This function
is provided only for compatibility with applications written for versions of
Windows earlier than 3.0. For Win32-based applications, use the CreateDIBPatternBrushPt function.
HBRUSH CreateDIBPatternBrush(
|
HGLOBAL hglbDIBPacked, |
// handle to
device-independent bitmap |
|
UINT fuColorSpec |
// color table data
|
|
); |
|
Parameters
hglbDIBPacked
Identifies a
global memory object containing a packed DIB, which consists of a BITMAPINFO structure immediately
followed by an array of bytes defining the pixels of the bitmap.
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.
fuColorSpec
Specifies
whether the bmiColors member of the BITMAPINFO structure is
initialized and, if so, whether this member contains explicit red, green, blue
(RGB) values or indices into a logical palette. The fuColorSpec
parameter must be one of the following values:
|
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. |
Return Values
If the
function succeeds, the return value identifies a logical brush.
If the
function fails, the return value is NULL.
Remarks
When an
application selects a two-color DIB pattern brush into a monochrome device
context, Windows 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.
See Also