勇芳软件工作室.汉化:  Colors > Color Functions >

GetNearestPaletteIndex

Previous pageReturn to chapter overviewNext page

描述

 

GetNearestPaletteIndex函数检索最接近匹配指定颜色值的指定逻辑调色板中条目的索引。

 

C++ 语法

 

UINT GetNearestPaletteIndex(

__in HPALETTE hpal,

__in COLORREF crColor

);

 

PowerBASIC 语法

 

FUNCTION GetNearestPaletteIndex ( _

BYVAL hpal AS DWORD, _

BYVAL crColor AS DWORD _

) AS DWORD

 

参数

 

hpal

 

[in]处理逻辑调色板。

 

crColor

 

[in]指定要匹配的颜色。要创建COLORREF颜色值,请使用RGB宏。

 

返回值

 

如果函数成功,则返回值是逻辑调色板中条目的索引。

 

如果函数失败,返回值为CLR_INVALID。

 

Windows NT / 2000 / XP / Vista / Windows 7:要获取扩展错误信息,请调用GetLastError.

 

备注

 

应用程序可以通过调用GetDeviceCaps函数并指定RASTERCAPS常数来确定设备是否支持调色板操作。

 

如果给定的逻辑调色板包含设置了PC_EXPLICIT标志的条目,则返回值是未定义的。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)