Функция CreateDIBPatternBrush создает логическую кисть, которая имеет узор, заданный указанным, не зависящим от устройства точечным рисунком (DIB). Кисть, впоследствии, может быть выбрана в какой-либо контекст устройства, связанный с устройством, которое поддерживает растровые операции.
Обратите внимание! на то, что эта функция предусматривается только для совместимости с 16-разрядными версиями Windows. Прикладные программы должны использовать функцию CreateDIBPatternBrushPt. |
Синтаксис
HBRUSH CreateDIBPatternBrush( HGLOBAL hglbDIBPacked, // дескриптор DIB UINT fuColorSpec // данные таблицы цвета ); |
Параметры
Windows 95: Создание кистей из точечных рисунков или DIB, больших, чем 8 на 8 пикселей, не поддерживаются. Если определяется больший точечный рисунок, используется только часть его.
Windows 98/Me и Windows NT/2000/XP: Кисти могут создаваться из точечных рисунков или аппаратно-независимых растровых форматов (DIB) больших, чем 8 на 8 пикселей.
Значение | Предназначение |
---|---|
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 |
Нет |
Замечания по платформе |
Не имеется |