GetDIBColorTable

【勇芳软件工作室】汉化Home

GetDIBColorTable函数从当前选定到指定设备上下文的DIB部分位图的颜色表中的条目范围中检索RGB(红,绿,蓝)颜色值。

UINT GetDIBColorTable(

HDC 【HDC】,// DIB感兴趣的设备上下文的句柄
UINT【uStartIndex】,//要检索的第一个条目的颜色表索引
UINT 【cEntries】,//要检索的颜色表条目数
RGBQUAD 【// pointer to buffer that receives color table entries】//指向接收颜色表条目的缓冲区的指针
); 

参数

【HDC】

指定设备上下文。必须在此设备上下文中选择DIB部分位图。

【uStartIndex】

基于零的颜色表索引,指定要检索的第一个颜色表条目。

【cEntries】

指定要检索的颜色表条目的数量。

【pColors】

指向从DIB的颜色表中接收包含颜色信息的RGBQUAD数据结构数组的缓冲区。缓冲区必须足够大,才能包含与【cEntries】的值一样多的RGBQUAD数据结构。

返回值

如果函数成功,则返回值是函数检索的颜色表条目数。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

应调用GetDIBColorTable函数来检索使用每像素1,4或8位的DIB部分位图的颜色表。位图关联的BITMAPINFOHEADER结构的biBitCount成员指定每像素的位数。具有大于8的biBitCount值的DIB部分位图没有颜色表,但它们具有关联的颜色掩码。调用GetObject函数来检索这些颜色掩码。

也可以看看

BITMAPINFOHEADER, CreateDIBSection, DIBSECTION, GetObject, RGBQUAD, SetDIBColorTable