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

Функция GetPaletteEntries извлекает указанный диапазон записей палитры из заданной логической палитры.

Синтаксис

UINT GetPaletteEntries(
  [in]  HPALETTE       hpal,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

Параметры

[in] hpal

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

[in] iStart

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

[in] cEntries

Количество записей в логической палитре для извлечения.

[out] pPalEntries

Указатель на массив структур PALETTEENTRY для получения записей палитры. Массив должен содержать по крайней мере столько структур, сколько указано в параметре nEntries .

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

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

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

Комментарии

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

Если параметр nEntries задает больше записей, чем существует в палитре, остальные члены структуры PALETTEENTRY не изменяются.

Требования

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

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

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

GetDeviceCaps

GetSystemPaletteEntries

PALETTEENTRY

SetPaletteEntries