Функция CreatePatternBrush создает логическую кисть с заданным точечным рисунком узора. Точечным рисунком может быть DIB секция битового образа, который создается функцией CreateDIBSection, или это может быть аппаратно-зависимый точечный рисунок.
Синтаксис
HBRUSH CreatePatternBrush( HBITMAP hbmp // дескриптор точечного рисунка ); |
Параметры
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 |
Нет |
Замечания по платформе |
Не имеется |