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

Статья
03/13/2024

Функция GetDIBColorTable извлекает значения цветов RGB (красный, зеленый, синий) из диапазона записей в таблице цветов растрового изображения раздела DIB, выбранного в данный момент в указанном контексте устройства.

Синтаксис

UINT GetDIBColorTable(
  [in]  HDC     hdc,
  [in]  UINT    iStart,
  [in]  UINT    cEntries,
  [out] RGBQUAD *prgbq
);

Параметры

[in] hdc

Дескриптор для контекста устройства. В этом контексте устройства необходимо выбрать растровое изображение раздела DIB.

[in] iStart

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

[in] cEntries

Количество извлекаемых записей таблицы цветов.

[out] prgbq

Указатель на буфер, который получает массив структур данных RGBQUAD , содержащих сведения о цвете из таблицы цветов DIB. Буфер должен быть достаточно большим, чтобы содержать столько структур данных RGBQUAD , сколько значение cEntries.

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

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

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

Необходимо вызвать функцию GetDIBColorTable , чтобы получить таблицу цветов для растровых изображений разделов DIB, использующих 1, 4 или 8 бит/с. Элемент biBitCount структуры BITMAPINFOHEADER , связанной с растровым изображением, указывает количество битов на пиксель. Растровые изображения разделов DIB со значением biBitCount больше восьми не имеют таблицы цветов, но имеют связанные цветовые маски. Вызовите функцию GetObject , чтобы получить эти цветовые маски.

Требования

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