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

Статья
08/27/2023

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

Синтаксис

UINT SetDIBColorTable(
  [in] HDC           hdc,
  [in] UINT          iStart,
  [in] UINT          cEntries,
  [in] const RGBQUAD *prgbq
);

Параметры

[in] hdc

Контекст устройства. В контексте этого устройства необходимо выбрать DIB.

[in] iStart

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

[in] cEntries

Количество записей таблицы цветов для задания.

[in] prgbq

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

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

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

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

Эта функция должна вызываться, чтобы задать таблицу цветов для dib, использующих 1, 4 или 8 bpp. Элемент BitCount структуры заголовка сведений о растровом рисунке, связанной с ним.

Структура BITMAPINFOHEADER указывает количество битов на пиксель. Независимые от устройства растровые изображения со значением biBitCount больше 8 не имеют таблицы цветов.

Элемент bV5BitCount структуры, связанной с растровым изображением BITMAPV5HEADER, указывает количество битов на пиксель. Независимые от устройства растровые изображения со значением bV5BitCount больше 8 не имеют таблицы цветов.

ICM: Управление цветом не выполняется.

Требования

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