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

另请参阅

COLORREF

颜色函数

颜色概述

GetDeviceCaps

GetNearestColor

GetPaletteEntries

GetSystemPaletteEntries

RGB