SetDIBColorTable (Compact 2013)
3/28/2014
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 |
See Also
Reference
GDI Functions
CreateDIBSection
GetDIBColorTable
GetObject
BITMAPINFOHEADER
DIBSECTION
RGBQUAD