Функция GetPaletteEntries

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

Синтаксис 

UINT GetPaletteEntries(
  HPALETTE hpal,        // дескриптор логической палитры
  UINT iStartIndex,     // первая извлекаемая запись
  UINT nEntries,        // число извлекаемых записей
  LPPALETTEENTRY lppe   // массив, который принимает записи
);

Параметры

hpal

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

iStartIndex

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

nEntries

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

lppe

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

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

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

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

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

Замечания

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

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

Смотри также 

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

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

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz