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


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

Функция 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

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

BITMAPINFOHEADER

Функции точечных рисунков

Общие сведения о точечных изображениях

CreateDIBSection

DIBSECTION

GetObject

RGBQUAD

SetDIBColorTable