SetDIBColorTable

SetDIBColorTable是用來對目前進入指定設備環境的設備無關點陣圖（DIB）顏色表中的項設定RGB（紅、綠、藍）顏色值的函式

基本介紹

• 中文名：SetDIBColorTable
• Windows NT：3.5及以上版本
• Windows：95
• Windows CE：不支持

函式功能

該函式用來對目前進入指定設備環境的設備無關點陣圖（DIB）顏色表中的項設定RGB（紅、綠、藍）顏色值。

函式原型

UINT SetDIBColorTable(HDC hdc, UINT uStartindex, UINT cEntries, CONST RGBQUAD *pColors)；

參數

hdc：指定設備環境。一個與設備無關點陣圖必須被選入到該設備環境中。

uStartindex：一個從零開始的顏色表索引，該索引指定了要設定的第1個顏色表項。

cEntries：指定要設定的顏色表項的數目。

pColors：指向RGBQUAD結構數組的指針。該結構包含了用於DIB顏色表的新顏色信息。

返回值：如果函式執行成功，那么返回值就是該函式設定的顏色表項的數目；如果函式執行失敗，那么返回值為0。Windows NT：若想獲得更多錯誤信息，請調用GetLastError函式。

備註：使用該函式是用來對那些使用1、4、或8位/像素格式的DIB點陣圖的顏色表進行設定的。點陣圖信息頭結構中的成員BitCount表示了點陣圖中每像素占多少位這種信息。

注意：點陣圖信息頭結構可以為：

Windows NT 3.51和以前版；BITMAPINFOHEADER，BITMAPINFOHEADER結構指定了每像素占多少位。BiBitCount值大於8的設備無關點陣圖（DIB）沒有顏色表。

Windows NT 4.0和Windows 95：BITMAPV4HEADER，對於Windows NT 4.0和Windows 95，與點陣圖相關的BITMAPV4HEADER結構成員bV 4BitCount指定了每像素點占的位數。bV 4BitCount值大於8的DIB沒有顏色表。

Windows NT 5.0和Windows 98：BITMAPV5HEADER，對於Windows NT 5.0和Windows 98，與點陣圖相關的BITMAPV4HEADER結構中的成員bV 5BitCount指定了點陣圖中每像素點占的位數。bV 5BitCount值大於8的DIB點陣圖沒有顏色表。

ICM：不進行顏色管理。

速查：Windows NT：3.5及以上版本；Windows：95及以上版本；Windows CE：不支持；頭檔案：wingdi.h：庫檔案：gdi32.lib。