GetSystemPaletteEntries

Функция GetSystemPaletteEntries извлекает диапазон вхождений в палитру из системной палитры, которая связана с указанным контекстом устройства (device context).

UINT GetSystemPaletteEntries (
  HDC hdc , // дескриптор контекста устройства
  UINT iStartIndex , // первое извлекаемое вхождение в палитру
  UINT nEntries , // количество извлекаемых вхождений в палитру
  LPPALETTEENTRY lppe // массив, получающий вхождения в палитру
);

Параметры

hdc - дескриптор контекста устройства
iStartIndex - определяет первое извлекаемое вхождение в системную палитру.
nEntries - определяет количество извлекаемых из системной палитры вхождений.
lppe - указатель на массив структур типа PALETTEENTRY для получения вхождений в палитру. Число элементов в массиве должно быть не меньше значения, заданного параметром nEntries . Если значение параметра lppe равно NULL, функция возвращает общее количество вхождений в системную палитру.

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

В случае успеха возвращается количество вхождений, извлеченных из палитры.
В случае неудачи возвращается нуль.
Windows NT/2000/XP: Для получения дополнительной информации об ошибке вызовите функцию GetLastError.

Комментарии

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

Требования

Windows NT/2000/XP: Включена в Windows NT 3.1 и выше.
Windows 95/98/Me: Включена в Windows 95 и выше.
Заголовок: Объявлена в Wingdi.h; подключатьWindows.h.
Библиотека: Используйте Gdi32.lib.

См. также

GetDeviceCaps, GetPaletteEntries, PALETTEENTRY.