Поделиться через


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

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

Синтаксис

UINT GetSystemPaletteEntries(
  [in]  HDC            hdc,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

Параметры

[in] hdc

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

[in] iStart

Первая запись, извлекаемая из системной палитры.

[in] cEntries

Количество записей, извлекаемых из системной палитры.

[out] pPalEntries

Указатель на массив структур PALETTEENTRY для получения записей палитры. Массив должен содержать по крайней мере столько же структур, сколько указано в параметре cEntries . Если этот параметр имеет значение NULL, функция возвращает общее количество записей в палитре.

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

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

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

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

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

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

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

GetDeviceCaps

GetPaletteEntries

PALETTEENTRY