Функция 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 не изменяются.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |