SetDIBColorTable 関数 (wingdi.h)

SetDIBColorTable 関数は、指定されたデバイスコンテキストに現在選択されている DIB のカラーテーブル内のエントリの範囲に RGB (赤、緑、青) の色値を設定します。

構文

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

[in] hdc

デバイスコンテキスト。このデバイスコンテキストで DIB を選択する必要があります。

[in] iStart

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

[in] cEntries

設定するカラーテーブルエントリの数。

[in] prgbq

DIB のカラーテーブルの新しい色情報を含む RGBQUAD 構造体の配列へのポインター。

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

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

この関数は、1、4、または 8 bpp を使用する DIB のカラーテーブルを設定するために呼び出す必要があります。ビットマップに関連付けられているビットマップ情報ヘッダー構造体の BitCount メンバー。

BITMAPINFOHEADER 構造体は、ピクセルあたりのビット数を指定します。 biBitCount 値が 8 より大きいデバイスに依存しないビットマップには、カラーテーブルがありません。

ビットマップに関連付けられたBITMAPV5HEADER構造体の bV5BitCount メンバーは、ピクセルあたりのビット数を指定します。 bV5BitCount 値が 8 より大きいデバイスに依存しないビットマップには、カラーテーブルがありません。

Icm： カラー管理は実行されません。

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