GetDIBColorTable 関数 (wingdi.h)
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 |