Функция CreatePatternBrush

Функция CreatePatternBrush создает логическую кисть с заданным точечным рисунком узора. Точечным рисунком может быть  DIB секция битового образа, который создается функцией CreateDIBSection, или это может быть аппаратно-зависимый точечный рисунок.

Синтаксис

HBRUSH CreatePatternBrush(
  HBITMAP hbmp   // дескриптор точечного рисунка
);

Параметры

hbmp
[in] Дескриптор используемого точечного рисунка, который  создает логическую кисть.

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

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

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

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

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

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

Замечания

Кисть - это точечный рисунок, который система использует, чтобы красить внутренние части заполняемых форм.

После того, как приложение создаст кисть при помощи вызова функции CreatePatternBrush, оно может выбрать её в какой-либо контекст устройства при помощи вызова функции SelectObject.

Вы можете удалить узорную кисть, не влияя на связанный точечный рисунок, используя функцию DeleteObject. Поэтому, Вы можете затем использовать этот точечный рисунок, чтобы создать любое определенное число узорных кисти.

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

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

Код примера

Пример, см. в статье Использование кистей.

Смотри также 

Обзор Кисти, Функции, используемые кистями,  CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateDIBSection, CreateHatchBrush, DeleteObject, GetBrushOrgEx, LoadBitmap, SelectObject, SetBrushOrgEx

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

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