描述
GetDIBColorTable功能从当前选定到指定设备上下文的DIB部分位图的颜色表中的条目范围中检索RGB（红色，绿色，蓝色）颜色值。
C++ 语法
UINT GetDIBColorTable( __in HDC hdc, __in UINT uStartIndex, __in UINT cEntries, __out RGBQUAD *pColors ); |
PowerBASIC 语法
FUNCTION GetDIBColorTable( _ BYVAL hdc AS DWORD, _ BYVAL uStartIndex AS DWORD, _ BYVAL cEntries AS DWORD, _ BYREF pColors AS RGBQUAD _ ) AS DWORD |
参数
hdc
[in]处理设备上下文。必须在此设备上下文中选择DIB部分位图。
uStartIndex
[in]基于零的颜色表索引，指定要检索的第一个颜色表条目。
cEntries
[in]指定要检索的颜色表条目的数量。
pColors
[out]指向缓冲区的指针，该缓冲区从DIB颜色表接收包含颜色信息的RGBQUAD数据结构数组。缓冲区必须足够大以包含cEntries的RGBQUAD数据结构。
返回值
如果函数成功，则返回值是函数检索的颜色表条目数。
如果函数失败，返回值为零。
Windows NT / 2000 / XP / Vista / Windows 7：要获取扩展错误信息，请调用GetLastError.
备注
应调用GetDIBColorTable函数来检索使用1,4或8 bpp的DIB部分位图的颜色表。位图关联BITMAPINFOHEADER结构的biBitCount成员指定每像素位数。具有大于8的biBitCount值的DIB部分位图没有颜色表，但它们具有关联的颜色掩码。调用GetObject函数来检索这些颜色掩码。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）