Функция 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 связан с растровой информацией заголовочной структуры точечного рисунка.
|
Обратите внимание! на то, что растровой информационной заголовочной структурой может быть одна из ниже перечисленных
|
Структура 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 |
Нет |
|
Замечания по платформе |
Не имеется |