描述
SetDIBColorTable功能将当前选择的DIB的颜色表中的条目范围中的RGB（红色，绿色，蓝色）颜色值设置到指定的设备上下文中。
C++ 语法
UINT SetDIBColorTable( __in HDC hdc, __in UINT uStartIndex, __in UINT cEntries, __in const RGBQUAD *pColors ); |
PowerBASIC 语法
FUNCTION SetDIBColorTable( _ HDC hdc AS DWORD, _ UINT uStartIndex AS DWORD, _ UINT cEntries AS DWORD, _ BYREF pColors AS RGBQUAD _ ) AS DWORD |
参数
hdc
[in]指定设备上下文。必须在此设备上下文中选择DIB。
uStartIndex
[in]基于零的颜色表索引，指定要设置的第一个颜色表条目。
cEntries
[in]指定要设置的颜色表条目的数量。
pColors
[in]指向包含DIB颜色表的新颜色信息的RGBQUAD结构数组的指针。
返回值
如果函数成功，则返回值是函数设置的颜色表条目的数量。
如果函数失败，返回值为零。
Windows NT / 2000 / XP / Vista / Windows 7：要获取扩展错误信息，请调用GetLastError.
备注
应调用此函数为使用1,4或8 bpp的DIB设置颜色表。位图关联的位图信息头结构的BitCount成员。
注意位图信息头结构可能是以下之一。
操作系统 |
位图信息头 |
Windows NT 3.51及更早版本 |
BITMAPINFOHEADER |
Windows 95和Windows NT 4.0 |
BITMAPV4HEADER |
Windows 98 / Me和Windows 2000 |
BITMAPV5HEADER |
BITMAPINFOHEADER结构指定每像素的位数。具有大于8的biBitCount值的与设备无关的位图没有颜色表。
Windows 95，Windows NT 4.0：位图关联的BITMAPV4HEADER结构的bV4BitCount成员指定每像素的位数。具有大于8的bV4BitCount值的与设备无关的位图没有颜色表。
Windows 98 / Me，Windows 2000 / XP：位图关联的BITMAPV5HEADER结构的bV5BitCount成员指定每像素的位数。与bV5BitCount值大于8的设备无关位图没有颜色表。
ICM：不执行颜色管理。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）