name="google_ads_frame" marginwidth="0" marginheight="0" src="http://pagead2.googlesyndication.com/pagead/ads?client=ca-pub-5572165936844014&dt=1193665761703&lmt=1193665780&format=336x280_as&output=html&correlator=1193665761687&url=http%3A%2F%2Fwww.codeguru.cn%2Fpublic%2Fiframe%2Fwinapiiframe.htm&color_bg=FFFFFF&color_text=000000&color_link=000000&color_url=FFFFFF&color_border=FFFFFF&ad_type=text&ga_vid=1285758818.1193665762&ga_sid=1193665762&ga_hid=111695597&flash=9&u_h=768&u_w=1024&u_ah=740&u_aw=1024&u_cd=32&u_tz=480&u_his=8&u_java=true" frameborder="0" width="336" scrolling="no" height="280" allowtransparency="allowtransparency">
函数功能:该函数从DIB位图的颜色表中检索RGB(红、绿、蓝)颜色值,此DIB位图是当前选入指定设备环境中的位图。
函数原型: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。
函数原型: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。