SetDIBColorTable

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function sets red, green, and blue color values in a range of entries in the color table of the DIB that is currently selected into a specified device context.

Syntax

WINGDIAPI UINT WINAPI SetDIBColorTable(
  HDC hdc,
  UINT uStartIndex,
  UINT cEntries,
  CONST RGBQUAD* pColor
);

Parameters

  • hdc
    [in] Handle to a device context.

    A DIB must be selected into this device context.

  • uStartIndex
    [in] Unsigned integer that that specifies a zero-based index of the first color table entry that you want to set.
  • cEntries
    [in] Unsigned integer that specifies the number of color table entries that you want to set.
  • pColor
    [in] Pointer to an array of RGBQUAD structures that contain new color information for the color table of the DIB.

Return Value

The number of color table entries that the function sets indicates success.

Zero indicates failure.

To get extended error information, call GetLastError.

Remarks

Call SetDIBColorTable to set the color table for DIBs that use 1, 4, or 8 bpp.

The biBitCount member of the BITMAPINFOHEADER structure that corresponds to a bitmap specifies the number of bpp.

Device-independent bitmaps that have a biBitCount value greater than 8 do not have a color table.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CreateDIBSection
GetDIBColorTable
GetObject
BITMAPINFOHEADER
DIBSECTION
RGBQUAD