Функция GetNearestPaletteIndex


Функция GetNearestPaletteIndex извлекает индекс для записи в указанной логической палитре, наиболее близко соответствующей указанному коду цвета.

Синтаксис

UINT GetNearestPaletteIndex(
  HPALETTE hpal,     // дескриптор логической палитры
  COLORREF crColor   // цвет, который соответствует
);

Параметры

hpal

[in] Дескриптор логической палитры.

crColor

[in] Определяет цвет, который подбирается. Чтобы создать код цвета COLORREF, используйте макрос RGB.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение - индекс записи в логической палитре.

Если функция завершается ошибкой, возвращаемое значение - CLR_INVALID.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Приложение может определить, поддерживает ли устройство операции палитры  при помощи вызова функции GetDeviceCaps и определения константы RASTERCAPS.

Если данная логическая палитра содержит записи с установленным флажком PC_EXPLICIT, возвращаемое значение не определяется.

Смотри также 

Обзор Цвета, Функции, используемые цветом,  GetDeviceCaps, GetNearestColor, GetPaletteEntries, GetSystemPaletteEntries, COLORREF, RGB

Размещение и совместимость GetNearestPaletteIndex

К Windows XP Да 
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.1 и выше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
 
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Да
в    
е    
р    
Используемая библиотека Gdi32.lib
Используемая DLL -
 Заголовочный файл  
- объявлено в Wingdi.h
 - включено в Windows.h
 Unicode Нет
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz