CBitmap::CreateBitmap

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

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

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

Параметры

nWidth

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

nHeight

Указывает высоту (в точках) растрового изображения.

nPlanes

Указывает количество плоскостей цвета в точечный рисунок.

nBitcount

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

lpBits

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

Примечания

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

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

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

Когда вы закончите с CBitmap объект, созданный с помощью функции CreateBitmap , сначала выберите точечный рисунок из контекста устройства, а затем удалить объект CBitmap.

Для получения дополнительной информации смотрите описание bmBits поля в структуре BITMAP . В функции-члена CBitmap::CreateBitmapIndirect описывается структура точечного РИСУНКА.

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

См. такжеnbsp;CDC::SelectObject, CGdiObject::DeleteObject, CDC::BitBlt, :: CreateBitmap

Index