GetNearestPaletteIndex

GetNearestPaletteIndex 関数は、指定した論理パレット内で、指定カラー値に最も近いエントリのインデックスを取得する。

GetNearestPaletteIndex h, color

h : [intptr] 論理パレットのハンドル。
color : [int] 一致させる色。COLORREF カラー値を作成するには RGB マクロを使用する。

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

解説

GetNearestPaletteIndex 関数は、指定した論理パレット内で、指定カラー値に最も近いエントリのインデックスを取得する。

[戻り値]
関数が成功した場合、戻り値は論理パレット内のエントリのインデックスである。失敗した場合は CLR_INVALID を返す。

[備考]
アプリケーションは GetDeviceCaps 関数を呼び出し RASTERCAPS
定数を指定することで、デバイスがパレット操作をサポートしているかを判定できる。指定した論理パレットに PC_EXPLICIT
フラグが立ったエントリが含まれる場合、戻り値は未定義である。

情報