Функция CreateDIBPatternBrushPt


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

Синтаксис
HBRUSH CreateDIBPatternBrushPt(
  CONST VOID *lpPackedDIB,  // биты точечного рисунка
  UINT iUsage               // использование
);
Параметры
lpPackedDIB
[in] Указатель на сжатый растровый формат (DIB), состоящий из структуры BITMAPINFO, непосредственно сопровождаемой массивом байтов, определяющих пиксели точечного рисунка.

Windows 95: Создание кистей из точечных рисунков или DIB, больших, чем 8 на 8 пикселей, не поддерживаются. Если определяется больший точечный рисунок, используется только часть его.

Windows 98/Me и Windows NT/2000/XP: Кисти могут создаваться из точечных рисунков или аппаратно-независимых растровых форматов (DIB) больших, чем 8 на 8 пикселей.

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

 

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

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

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

Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL).

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Кисть - точечный рисунок, который система использует, чтобы окрашивать внутренние части заполняемых форм.

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

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

Независимое управление цветом (ICM): При создании кисти цвет не создается. Однако, управление цветом выполняется тогда, когда кисть выбрана во включающий ICM контекст устройства.

Смотри также 

Обзор Кисти, Функции, используемые кистями,  BITMAPINFO, CreateDIBPatternBrush, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush, DeleteObject, GetBrushOrgEx, SelectObject, SetBrushOrgEx

Размещение и совместимость CreateDIBPatternBrushPt

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Gdi32.lib

Заголовочный файл

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz