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

Назад в оглавление

На главную страницу

На оглавление справки