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

Статья
03/09/2024

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

Примечание Эта функция предоставляется только для совместимости с 16-разрядными версиями Windows. Приложения должны использовать функцию CreateDIBPatternBrushPt .

Синтаксис

HBRUSH CreateDIBPatternBrush(
  [in] HGLOBAL h,
  [in] UINT    iUsage
);

Параметры

[in] h

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

[in] iUsage

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

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

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

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

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

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

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

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

Требования

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