GetDIBColorTable

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

GetDIBColorTable hdc, iStart, cEntries, prgbq

hdc : [intptr] デバイスコンテキストのハンドル。DIB セクションビットマップがこのデバイスコンテキストに選択されていなければならない。
iStart : [int] 取得する最初のカラーテーブルエントリを指定する、0 から始まるカラーテーブルインデックス。
cEntries : [int] 取得するカラーテーブルエントリ数。
prgbq : [var] DIB カラーテーブルのカラー情報を含む RGBQUAD データ構造の配列を受け取るバッファへのポインタ。バッファは cEntries の値と同じ数の RGBQUAD 構造体を格納できる十分な大きさでなければならない。

(プラグイン / モジュール : gdi32.dll)

解説

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

[戻り値]
関数が成功した場合、戻り値は取得したカラーテーブルエントリ数である。失敗した場合は 0 である。

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

情報