函数功能:该函数从DIB位图的颜色表中检索RGB(红、绿、蓝)颜色值,此DIB位图是当前选入指定设备环境中的位图。
1 |
UINT GetDIBColorTable(HDC hdc,UINt uStartindex, UINT cEntries, RGBQUAD *pColors) |
参数:
hdc:指定设备环境,DIB类位图必须选入到该设备环境中。
uStartindex:一个从零开始的颜色表索引值,该索引值指定了要检索的第1个颜色色表项。
cEntries:指定要检索的颜色表项的数目。
pColors:指向一个缓冲区的指针,该缓冲区接收一个RGBQUAD结构数值,该结构包含DIB颜色表中的颜色信息。该缓冲区必须足够大,以包含象cEntries参数值一样多的RGBQUAD数据结构。
返回值:如果函数执行成功,那么返回值就是函数检索到的颜色表项的数目;如果函数执行失败,那么返回值为0。
Windows NT:若想获得更多错误信息,请调用GetLastError函数。
备注:GetDIBColorTable函数应该是用来检索使用1、4或8位像素点格式的DIB位图的颜色表的,与位图相关的BITMAPINFOHEADER结构中的成员biBitCount规定了每个像素点的位数。biBitCount值大于8的DIB类位图没有颜色表,但它们有相关的颜色掩码。可以调用GetObject函数来检索那些颜色掩码。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;头文件:wingdi.h;库文件:gdi32.lib。