GetDIBColorTable 函式 (wingdi.h)

發行項
03/13/2024

GetDIBColorTable 函式會擷取 RGB (紅色、綠色、藍色) 色彩值，這些值會從目前選取到指定裝置內容的 DIB 區段位圖色彩數據表中的專案範圍擷取。

語法

UINT GetDIBColorTable(
  [in]  HDC     hdc,
  [in]  UINT    iStart,
  [in]  UINT    cEntries,
  [out] RGBQUAD *prgbq
);

參數

[in] hdc

裝置內容的控制代碼。必須在此裝置內容中選取 DIB 區段位圖。

[in] iStart

以零起始的色彩表索引，指定要擷取的第一個色彩數據表專案。

[in] cEntries

要擷取的色彩數據表項目數目。

[out] prgbq

緩衝區的指標，接收來自 DIB 色彩數據表之色彩資訊的 RGBQUAD 數據結構陣列。緩衝區必須夠大，才能包含與 cEntries 值一樣多的 RGBQUAD 數據結構。

傳回值

如果函式成功，傳回值就是函式所擷取的色彩數據表項目數目。

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

備註

應該呼叫 GetDIBColorTable 函式，以擷取使用 1、4 或 8 bpp 之 DIB 區段位圖的色彩數據表。位圖相關 BITMAPINFOHEADER 結構的 biBitCount 成員會指定每個圖元的位數。 具有 biBitCount 值大於 8 的 DIB 區段位圖沒有色彩表，但它們有相關聯的色彩遮罩。呼叫 GetObject 函式以擷取這些色彩遮罩。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll