GetDIBColorTable 関数 (wingdi.h)

[アーティクル]
08/08/2024

GetDIBColorTable 関数は、指定されたデバイスコンテキストに現在選択されている DIB セクションビットマップのカラーテーブル内のエントリの範囲から RGB (赤、緑、青) の色値を取得します。

構文

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

パラメーター

[in] hdc

デバイスコンテキストを識別するハンドル。このデバイスコンテキストでは、DIB セクションビットマップを選択する必要があります。

[in] iStart

取得する最初のカラーテーブルエントリを指定する 0 から始まるカラーテーブルインデックス。

[in] cEntries

取得するカラーテーブルエントリの数。

[out] prgbq

DIB カラーテーブルから色情報を含む RGBQUAD データ構造体の配列を受け取るバッファーへのポインター。バッファーは、cEntries の値と同じ数の RGBQUAD データ構造を格納するのに十分な大きさにする必要があります。

戻り値

関数が成功した場合、戻り値は、関数が取得するカラーテーブルエントリの数です。

関数が失敗した場合は、0 を返します。

注釈

1、4、または 8 bpp を使用する DIB セクションビットマップのカラーテーブルを取得するには、 GetDIBColorTable 関数を呼び出す必要があります。ビットマップに関連付けられた BITMAPINFOHEADER 構造体の biBitCount メンバーは、ピクセルあたりのビット数を指定します。 biBitCount 値が 8 より大きい DIB セクションビットマップにはカラーテーブルはありませんが、カラーマスクが関連付けられています。 GetObject 関数を呼び出して、これらのカラーマスクを取得します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll