Функция 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 | Нет | |
Замечания по платформе | Не имеется |