Функция SetDIBColorTable


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

Синтаксис

UINT SetDIBColorTable(
  HDC hdc,               // дескриптор DC
  UINT uStartIndex,      // первая запись индекса таблицы цветов
  UINT cEntries,         // число записей таблицы цветов
  CONST RGBQUAD *pColors // массив записей таблицы цветов
);

Параметры

hdc

[in] Определяет контекст устройства. Аппаратно-независимый растровый формат (DIB) должен выбираться в этот контекст устройства.

uStartIndex

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

cEntries

[in] Определяет число установленных записей в таблице цветов.

pColors

[in]  Указатель на массив структур RGBQUAD, содержащих информацию о новых цветах из таблицы цветов аппаратно-независимого растрового формата (DIB). 

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

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

Если функция завершается с ошибкой, величина возвращаемого значения - нуль.

Windows NT/2000/XP: Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.

Замечания

Эта функция должна вызваться, чтобы установить таблицу цветов для DIB-секций, которые используют 1, 4 или 8 битов на пиксель (bpp). Член biBitCount связан с растровой информацией заголовочной структуры точечного рисунка.

Обратите внимание! на то, что растровой информационной заголовочной структурой может быть одна из ниже перечисленных

Операционная система Заголовочная растровая  информация 
Windows NT 3.51 и ниже BITMAPINFOHEADER
Windows 95 и Windows NT 4.0 BITMAPV4HEADER
Windows 98/Me и Windows 2000 BITMAPV5HEADER

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

Windows 95, Windows NT 4.0: член bV4BitCount  связанной структуры BITMAPV4HEADER точечного рисунка устанавливает число битов на пиксель. Не зависящие от устройства точечные рисунки со значением bV4BitCount большим чем 8 не имеют таблицы цветов.

Windows 98/Me, Windows 2000/XP: член bV5BitCount  связанной структуры BITMAPV5HEADER точечного рисунка устанавливает число битов на пиксель. Не зависящие от устройства точечные рисунки со значением bV5BitCount большим чем 8 не имеют таблицы цветов.

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

Смотри также 

Обзор Точечные рисунки, Функции, используемые точечными рисунками, BITMAPINFOHEADER, CreateDIBSection, DIBSECTION, GetDIBColorTable, GetObject, RGBQUAD 

Размещение и совместимость SetDIBColorTable

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.5 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Gdi32.lib

Заголовочный файл

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz