Функция SetPaletteEntries

Функция SetPaletteEntries устанавливает RGB (красный, зеленый, синий) коды цвета и флажки в диапазоне записей в логической палитре.

Синтаксис

UINT SetPaletteEntries(
  HPALETTE hpal,             // дескриптор логической палитры
  UINT iStart,               // индекс первой устанавливаемой записи
  UINT cEntries,             // число устанавливаемых записей
  CONST PALETTEENTRY *lppe   // массив записей палитры
);

Параметры

hpal

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

iStart

[in] Определяет первую устанавливаемую запись логической палитры.

cEntries

[in] Определяет число устанавливаемых записей логической палитры.

lppe

[in] Указатель на первый член массива структур PALETTEENTRY, содержащих в себе значения RGB и флажки.

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

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

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

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

Замечания

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

Даже если логическая палитра была выбрана и реализована, изменения палитры не затрагивают физическую палитру внешнего вида. Функция RealizePalette должна быть вызвана снова, чтобы установить новую логическую палитру на поверхность изображения.

Смотри также

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

Размещение и совместимость SetPaletteEntries
К	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		Нет
Замечания по платформе		Не имеется

Назад в оглавление

На главную страницу

В оглавление справки