Функция CreatePatternBrush (wingdi.h)

Статья
08/27/2023

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

Синтаксис

HBRUSH CreatePatternBrush(
  [in] HBITMAP hbm
);

Параметры

[in] hbm

Дескриптор растрового изображения, используемого для создания логической кисти.

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

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

Если функция завершается сбоем, возвращается значение NULL.

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

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

ICM: Цвет при создании кисти не выполняется. Однако управление цветом выполняется, когда кисть выбрана в контексте устройства с поддержкой ICM.

Примеры

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll