Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

SetDIBColorTable function

The SetDIBColorTable function sets RGB (red, green, 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


UINT SetDIBColorTable(
  _In_  HDC hdc,
  _In_  UINT uStartIndex,
  _In_  UINT cEntries,
  _In_  const RGBQUAD *pColors
);

Parameters

hdc [in]

A device context. A DIB must be selected into this device context.

uStartIndex [in]

A zero-based color table index that specifies the first color table entry to set.

cEntries [in]

The number of color table entries to set.

pColors [in]

A pointer to an array of RGBQUAD structures containing new color information for the DIB's color table.

Return value

If the function succeeds, the return value is the number of color table entries that the function sets.

If the function fails, the return value is zero.

Remarks

This function should be called to set the color table for DIBs that use 1, 4, or 8 bpp. The BitCount member of a bitmap's associated bitmap information header structure.

BITMAPINFOHEADER structure specifies the number of bits-per-pixel. Device-independent bitmaps with a biBitCount value greater than 8 do not have a color table.

The bV5BitCount member of a bitmap's associated BITMAPV5HEADER structure specifies the number of bits-per-pixel. Device-independent bitmaps with a bV5BitCount value greater than 8 do not have a color table.

ICM: No color management is performed.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Bitmaps Overview
Bitmap Functions
BITMAPINFOHEADER
CreateDIBSection
GetDIBColorTable
GetObject
DIBSECTION
RGBQUAD

 

 

Build date: 6/12/2013

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.