GetNearestPaletteIndex 関数 (wingdi.h)

GetNearestPaletteIndex 関数は、指定された色の値に最も近い、指定された論理パレット内のエントリのインデックスを取得します。

構文

UINT GetNearestPaletteIndex(
  [in] HPALETTE h,
  [in] COLORREF color
);

[in] h

論理パレットへのハンドル。

[in] color

一致する色。 COLORREF カラー値を作成するには、RGB マクロを使用します。

関数が成功した場合、戻り値は論理パレット内のエントリのインデックスです。

関数が失敗した場合、戻り値は CLR_INVALID です。

アプリケーションは、 GetDeviceCaps 関数を呼び出し、RASTERCAPS 定数を指定することで、デバイスがパレット操作をサポートしているかどうかを判断できます。

指定された論理パレットに、PC_EXPLICIT フラグが設定されたエントリが含まれている場合、戻り値は未定義です。

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