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


CBitmap::CreateBitmap

Инициализирует растровое изображение памяти для зависимого объекта, имеет определенные, ширину и высоту битовый шаблон.

BOOL CreateBitmap( 
   int nWidth, 
   int nHeight, 
   UINT nPlanes, 
   UINT nBitcount, 
   const void* lpBits  
);

Параметры

  • nWidth
    Задает ширину (в пикселях) растрового изображения.

  • nHeight
    Задает высоту (в пикселях) растрового изображения.

  • nPlanes
    Указывает число самолетов цвета в различных форматах.

  • nBitcount
    Определяет количество битов цвета на пиксель отображения.

  • lpBits
    Указывает на массив байтов, содержащий исходное значение бита растрового изображения. Если значение NULL, то новый растровое изображение извлекается не инициализируется.

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

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

Заметки

Для растрового изображения цвета или nPlanes, или параметр nBitcount должно быть задано значение 1. Если оба этих параметров задано значение 1, то метод CreateBitmap создает монохромное растровое изображение.

Хотя растровое изображение непосредственно выбирать для отображения, его можно выбрать в качестве текущего растровое изображение для "контекста устройством хранения" с помощью CDC::SelectObject и скопировать в любой совместимому контексту устройства с помощью функции CDC::BitBlt.

По окончании, с объектом CBitmap, созданный функцией CreateBitmap, сначала нужно выделить растровое изображение из контекста устройства, то удалите объект CBitmap.

Дополнительные сведения см. в описании поля bmBits структуры BITMAP. Структура РАСТРОВОЕ ИЗОБРАЖЕНИЕ функцией-членом описана в разделе CBitmap::CreateBitmapIndirect.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CBitmap

Диаграмма иерархии

CDC::SelectObject

CGdiObject::DeleteObject

CDC::BitBlt

CreateBitmap