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

Функция CreateDIBPatternBrushPt создает логическую кисть с шаблоном, заданным независимым от устройства растровым рисунком (DIB).

Синтаксис

HBRUSH CreateDIBPatternBrushPt(
  [in] const VOID *lpPackedDIB,
  [in] UINT       iUsage
);

Параметры

[in] lpPackedDIB

Указатель на упакованный DIB, состоящий из структуры BITMAPINFO , сразу за которой следует массив байтов, определяющий пиксели растрового изображения.

[in] iUsage

Указывает, содержит ли элемент bmiColors структуры BITMAPINFO допустимую таблицу цветов и, если да, содержат ли записи в этой таблице цветов явные красные, зеленые, синие (RGB) значения или индексы палитры. Параметр iUsage должен иметь одно из следующих значений.

Значение Значение
DIB_PAL_COLORS
Таблица цветов предоставляется и состоит из массива 16-разрядных индексов в логической палитре контекста устройства, в котором должна быть выбрана кисть.
DIB_RGB_COLORS
Предоставляется таблица цветов, содержащая литеральные значения RGB.

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

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

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

Комментарии

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

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

Если кисть больше не нужна, вызовите функцию DeleteObject , чтобы удалить ее.

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

Требования

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

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

BITMAPINFO

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

Обзор кистей

CreateDIBPatternBrush

CreateHatchBrush

CreatePatternBrush

CreateSolidBrush

DeleteObject

GetBrushOrgEx

SelectObject

SetBrushOrgEx