getDIBColorTable 函数 (wingdi.h)
GetDIBColorTable 函数从当前选定到指定设备上下文的 DIB 节位图的颜色表中的一系列条目中检索 RGB (红、绿、蓝) 颜色值。
语法
UINT GetDIBColorTable(
[in] HDC hdc,
[in] UINT iStart,
[in] UINT cEntries,
[out] RGBQUAD *prgbq
);
参数
[in] hdc
设备上下文的句柄。 必须在此设备上下文中选择 DIB 节位图。
[in] iStart
一个从零开始的颜色表索引,指定要检索的第一个颜色表条目。
[in] cEntries
要检索的颜色表条目数。
[out] prgbq
指向缓冲区的指针,该缓冲区接收 RGBQUAD 数据结构数组,其中包含 DIB 颜色表中的颜色信息。 缓冲区必须足够大,才能包含与 cEntries 的值一样多的 RGBQUAD 数据结构。
返回值
如果函数成功,则返回值是函数检索的颜色表条目数。
如果函数失败,则返回值为零。
注解
应调用 GetDIBColorTable 函数来检索使用 1、4 或 8 bpp 的 DIB 节位图的颜色表。 与 BITMAPINFOHEADER 结构的位图关联的 biBitCount 成员指定每像素的位数。 biBitCount 值大于 8 的 DIB 节位图没有颜色表,但它们具有关联的颜色掩码。 调用 GetObject 函数以检索这些颜色掩码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | wingdi.h (包括 Windows.h) |
Library | Gdi32.lib |
DLL | Gdi32.dll |
另请参阅
GetObject