SetDIBColorTable功能在当前选定到指定设备上下文的与设备无关的位图(DIB)的颜色表中的条目范围内设置RGB(红,绿,蓝)颜色值。
UINT SetDIBColorTable(
HDC 【HDC】, | // DIB感兴趣的设备上下文的句柄 |
UINT【uStartIndex】, | //第一个条目的颜色表索引设置 |
UINT 【cEntries】, | //要设置的颜色表条目数 |
CONST RGBQUAD *【pColors】 | //指向颜色表条目数组的指针 |
); |
参数
【HDC】
指定设备上下文。必须在设备上下文中选择与设备无关的位图。
【uStartIndex】
基于零的颜色表索引,指定要设置的第一个颜色表条目。
【cEntries】
指定要设置的颜色表条目数。
【pColors】
指向包含DIB颜色表的新颜色信息的RGBQUAD结构数组。
返回值
如果函数成功,则返回值是函数设置的颜色表条目的数量。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
应该调用此函数来设置每个像素使用1,4或8位的器件无关位图的颜色表。位图关联的BITMAPINFOHEADER结构的biBitCount成员指定每像素的位数。具有大于8的biBitCount值的与设备无关的位图没有颜色表。
也可以看看
BITMAPINFOHEADER, CreateDIBSection, GetDIBColorTable, GetObject, DIBSECTION, RGBQUAD