Функция GetDIBColorTable


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

Синтаксис

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

Параметры

hdc

[in] Дескриптор контекста устройства. DIB-секция точечного рисунка должна быть выбрана в этот контекст устройства.

uStartIndex

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

cEntries

[in] Устанавливает извлекаемое число записей таблицы цветов.

pColors

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

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

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

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

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

Замечания

Функция GetDIBColorTable должна вызваться, чтобы извлечь таблицу цветов из DIB-секции  точечных рисунков, которые используют 1, 4 или 8 битов на пиксель (bpp). Член biBitCount структуры BITMAPINFOHEADER, связанной с точечным рисунком,  устанавливает число битов на пиксель. DIB-секция точечного рисунка со значением biBitCount большим чем восемь не имеет таблицы цветов, но они осуществляют связь с маской цвета. Вызовите функцию GetObject, чтобы извлечь эту маску цвета.

Смотри также 

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

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

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