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


Функция SetPaletteEntries (wingdi.h)

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

Синтаксис

UINT SetPaletteEntries(
  [in] HPALETTE           hpal,
  [in] UINT               iStart,
  [in] UINT               cEntries,
  [in] const PALETTEENTRY *pPalEntries
);

Параметры

[in] hpal

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

[in] iStart

Первая задается запись логической палитры.

[in] cEntries

Количество записей логической палитры, которые необходимо задать.

[in] pPalEntries

Указатель на первый элемент массива структур PALETTEENTRY , содержащих rgb-значения и флаги.

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

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

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

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

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

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

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

GetDeviceCaps

GetPaletteEntries

PALETTEENTRY

RealizePalette