共用方式為


GetDIBColorTable 函式 (wingdi.h)

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

另請參閱

BITMAPINFOHEADER

點陣圖函式

位圖概觀

CreateDIBSection

DIBSECTION

GetObject

RGBQUAD

SetDIBColorTable