Функция SetDIBColorTable (wingdi.h)
Функция 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 |