Поделиться через


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

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

Синтаксис

HBRUSH CreatePatternBrush(
  [in] HBITMAP hbm
);

Параметры

[in] hbm

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

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

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

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

Комментарии

Кисть узора — это растровое изображение, которое система использует для рисования внутренних элементов заполненных фигур.

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

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

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

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

Примеры

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

Требования

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

См. также раздел

Функции кисти

Обзор кистей

CreateBitmap

CreateBitmapIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateDIBSection

CreateHatchBrush

DeleteObject

GetBrushOrgEx

LoadBitmap

SelectObject

SetBrushOrgEx