CBrush::CreateDIBPatternBrush

BOOLCreateDIBPatternBrush(UINThPackedDIB, HGLOBALnUsage);

BOOL CreateDIBPatternBrush ( const void * lpPackedDIB, UINT nUsage );

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

Ненулевое значение, если успешно; в противном случае 0.

Параметры

hPackedDIB

Идентифицирует объект глобальной памяти, содержащий точечный упакованной аппаратно независимые (DIB).

nUsage

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

• DIB_PAL_COLORS   Таблица цветов состоит из массива 16-разрядных индексов.
  
  
• DIB_RGB_COLORS   Таблица цветов содержит литеральные значения RGB.

  Следующее значение доступно только во втором варианте этой функции-члена:

• DIB_PAL_I&NDICESnbsp;  Предоставляется не таблица цветов. Точечный рисунок, сама содержит индексы в логической палитру контекста устройства, в который выбрать кисть.

lpPackedDIB

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

Примечания

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

Две версии отличаются как вы можете распоряжаться DIB:

• В первой версии, чтобы получить дескриптор для DIB вызывается Windows :: GlobalAlloc функция для выделения блока глобальной памяти и затем заполнить память с упакованной Диб.
  
  
• Во втором варианте, не стоит называть :: GlobalAlloc для выделения памяти для упакованной Диб.

Упакованной Диб состоит из структуры данных BITMAPINFO , сразу же после массив байтов, который определяет пикселов растрового изображения. Растровые изображения, используемые как узоры заливки должно быть 8 x 8 пикселов. Если растровое изображение больше, Windows создает узора заливки, используя только биты, соответствующие первые 8 строк и 8 колонки пикселов в левом верхнем углу точечного рисунка.

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

Для получения сведений об использовании следующих функций Windows приведена в справочнике программиста Win32 SDK:

• :: CreateDIBPatternBrushnbsp;  (Эта функция предоставляется только для совместимости с приложениями, написанными для версии Windows более ранние, чем 3.0; используйте :: CreateDIBPatternBrushPt функции.)
  
  
• :: CreateDIBPatternBrushPtnbsp;  (Эта функция должна использоваться для Win32-приложений).
  
  
• :: GlobalAlloc

Обзор CBrush |  Члены класса | Иерархическая схема

См. также CBrush::CreatePatternBrush, CBrush::CreateBrushIndirect, CBrush::CreateSolidBrush, CBrush::CreateHatchBrush, CGdiObject::CreateStockObject, CDC::SelectObject, CGdiObject::DeleteObject, CDC::GetBrushOrg, CDC::SetBrushOrg