Gdi::CreateDIBPatternBrushPt_I

  • Article

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

static WINGDIAPI HBRUSH WINAPI CreateDIBPatternBrushPt_I(
  const void* lpPackedDIB,
  unsigned int iUsage
);

Parameters

  • lpPackedDIB
    [in] Long pointer to a packed DIB that consists of a BITMAPINFO structure immediately followed by an array of bytes that define the pixels of the bitmap.

  • iUsage
    [in] Unsigned integer that specifies whether the bmiColors member of the BITMAPINFO structure 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 following table shows the possible 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.
    DIB_RGB_COLORS A color table is provided and contains literal RGB values.

    Set the iUsage parameter to DIB_RGB_COLORS. When you use an 8 bits per pixel (bpp) bitmap, you can set iUsage to DIB_PAL_COLORS. In that case, however, Windows CE ignores the values in the bmiColors array member of the BITMAPINFO structure.

Return Values

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

Remarks

This method is an internal version of the CreateDIBPatternBrushPt function.

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

After an application creates a brush by calling Gdi::CreateDIBPatternBrushPt_I, the application can select that brush into any device context by calling the Gdi::SelectObject_I method.

When you no longer need the brush, call the Gdi::DeleteObject_I method to delete the brush.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Gdi.hpp.

See Also

CreateDIBPatternBrushPt | Gdi::CreateSolidBrush_I | Gdi::DeleteObject_I | Gdi::SelectObject_I | Gdi::SetBrushOrgEx_I | BITMAPINFO

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.