Функция GetSystemPaletteEntries


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

Синтаксис

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

Параметры

hdc

[in] Дескриптор контекста устройства.

iStartIndex

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

nEntries

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

lppe

[out] Указатель на массив структур PALETTEENTRY, которые принимают записи палитры. Массив должен содержать в себе по крайней мере столько же структур, как это определено параметром nEntries. Если этот параметр - НУЛЬ (NULL), функцией возвращается общее количество записей в палитре.

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

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

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

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

Замечания

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

Смотри также

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

Размещение и совместимость GetSystemPaletteEntries

К 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