Поделиться через


Функция 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
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

См. также раздел

COLORREF

Функции цвета

Общие сведения о цветах

GetDeviceCaps

GetNearestColor

GetPaletteEntries

GetSystemPaletteEntries

RGB