SetDIBColorTable

Windows Mobile 6.5
A version of this page is also available for
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.


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

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.

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

Zero indicates failure.

To get extended error information, call GetLastError.

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.

Headerwindows.h
Librarycoredll.lib
Windows Embedded CEWindows CE .NET 4.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

Show: