Функция 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 |
Нет |
|
Замечания по платформе |
Не имеется |