Функция CreateDIBPatternBrush


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

Обратите внимание! на то, что эта функция предусматривается только для совместимости с 16-разрядными версиями Windows. Прикладные программы должны использовать функцию CreateDIBPatternBrushPt.
Синтаксис
HBRUSH CreateDIBPatternBrush(
  HGLOBAL hglbDIBPacked,  // дескриптор DIB
  UINT fuColorSpec        // данные таблицы цвета
);
Параметры
hglbDIBPacked
[in] Дескриптор объекта глобальной памяти, содержащий сжатый аппаратно-независимый растровый формат (DIB), который состоит из структуры BITMAPINFO, непосредственно сопровождаемой массивом байтов, определяющих пиксели точечного рисунка.

Windows 95: Создание кистей из точечных рисунков или DIB, больших, чем 8 на 8 пикселей, не поддерживаются. Если определяется больший точечный рисунок, используется только часть его.

Windows 98/Me и Windows NT/2000/XP: Кисти могут создаваться из точечных рисунков или аппаратно-независимых растровых форматов (DIB) больших, чем 8 на 8 пикселей.

fuColorSpec
[in] Устанавливает, инициализирован ли член bmiColors структуры BITMAPINFO и, если это так, содержит ли этот член структуры значения  чистого красного, зеленого, синего (RGB) цвета или индексы в логической палитре. Параметром fuColorSpec должно быть одно из ниже перечисленных значений.
Значение Предназначение
DIB_PAL_COLORS Таблица цветов предусматривается и состоит из массива 16-разрядных индексов в логической палитре контекста устройства, в который  должна быть выбрана кисть.
DIB_RGB_COLORS Таблица цвета предусматривается и содержит точные RGB - значения.
 

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

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

Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL).

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Когда приложение выбирает двухцветную узорную кисть формата DIB  в монохромный контекст устройства, система не признает цвета, указанные в  формате (DIB); вместо этого, она показывает на экране узорную кисть, используя текущий цвета фона и изображения контекста устройства. Пиксели, отображенные первым цветом формата DIB (смещение 0 в таблице цветов DIB), показываются на экране, используя цвет изображения; пиксели, отображаемые вторым цветом (смещение 1 в таблице цветов),  показываются на экране, используя цвет фона.

Когда Вы больше не нуждаетесь в кисти, вызовите функцию DeleteObject, чтобы удалить её.

Независимое управление цветом (ICM): При создании кисти цвет не создается. Однако, управление цветом выполняется тогда, когда кисть выбрана во включающий ICM контекст устройства.

Смотри также 

Обзор Кисти, Функции, используемые кистями,  BITMAPINFO, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush, DeleteObject, SetBkColor, SetTextColor

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

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

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

Gdi32.lib

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

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz