SetDIBColorTable 函式 (wingdi.h)

SetDIBColorTable 函式會將 RGB (紅色、綠色、藍色) 色彩值設定為目前選取至指定裝置內容的 DIB 色彩數據表中的一系列專案。

語法

UINT SetDIBColorTable(
  [in] HDC           hdc,
  [in] UINT          iStart,
  [in] UINT          cEntries,
  [in] const RGBQUAD *prgbq
);

[in] hdc

裝置內容。必須在此裝置內容中選取 DIB。

[in] iStart

以零起始的色彩表索引，指定要設定的第一個色彩表格專案。

[in] cEntries

要設定的色彩表格項目數目。

[in] prgbq

RGBQUAD 結構的數位指標，其中包含 DIB 色彩數據表的新色彩資訊。

如果函式成功，則傳回值是函式所設定的色彩數據表項目數目。

如果此函式失敗，則傳回值為零。

應該呼叫此函式來設定使用 1、4 或 8 bpp 之 DIB 的色彩數據表。位圖相關聯位圖資訊標頭結構的 BitCount 成員。

BITMAPINFOHEADER 結構會指定每個圖元的位數。 具有 biBitCount 值大於 8 的裝置獨立點陣圖沒有色彩表格。

位圖相關聯BITMAPV5HEADER結構的 bV5BitCount 成員會指定每個圖元的位數。 具有 bV5BitCount 值大於 8 的裝置獨立點陣圖沒有色彩表格。

Icm： 不會執行色彩管理。