CDC::BitBlt

Статья
02/20/2013

Копирует растровое изображение из контекста устройства источника к этому текущий контекст устройства.

BOOL BitBlt(
   int x,
   int y,
   int nWidth,
   int nHeight,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   DWORD dwRop 
);

Параметры

x
Указывает логическое верхн- координату по оси x левого угла прямоугольника назначения.
y
Указывает логическое верхн- координату по оси y верхнего левого угла прямоугольника назначения.
nWidth
Задает ширину (в логических единицах) растрового изображения прямоугольников и источника назначения.
nHeight
Указывает высоту (в логических единицах) растрового изображения прямоугольников и источника назначения.
pSrcDC
Указатель на объект CDC, указывающий контекст устройства, из которого будет копируется растровое изображение.Это должно быть NULL если dwRop растровый, которая определяет операцию, не включающий источник.
xSrc
Идентифицирует логический координату по оси x левого угла верхн- растрового изображения источника.
ySrc
Идентифицирует логический координату по оси y верхнего левого верхн- растрового изображения источника.
dwRop
Указывает растровый операцию, которую необходимо выполнить.Коды Растр- операций определяют, как цвета GDI объединяет в операциях вывода, которые включают текущую кисть, возможно, растровое изображение источника и растровое изображение назначения.См. раздел передача битового блока в Windows SDK список кодов растр- операции для dwRop и их описание

Полный список кодов растр- операции см. в разделе О кодах операций растровый в Windows SDK.

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

Ненулевой если функция успешно; в противном случае – значение 0.

Заметки

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

Операции BitBlt на байт- выравниванных прямоугольниках значительно быстрее, чем операции BitBlt в прямоугольниках, которые не выравниванного байта.Если требуется задать стили класса, как байт- выравнивание для собственного контекста устройства, необходимо зарегистрировать класс окна, а не полагающся на классах Microsoft foundation, чтобы сделать его автоматически.Используйте глобальную функцию AfxRegisterWndClass.

Преобразование nWidth GDI и nHeight один раз, используя контекст устройства назначения, и один раз, используя контекст устройства источника.Если результирующее области памяти не совпадают, то GDI использует функцию Windows StretchBlt для сжатия или растянуть растровое изображение источника по мере необходимости.

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

Когда функция BitBlt преобразует растровое изображение монохромного для рисования, он устанавливает белые биты (1) в качестве значения цвет бит цвета фона и черноты (0) на первый план.Используются цвета фона и переднего плана контексте устройства назначения.Чтобы преобразовать цвета к монохромному, BitBlt задает точки, которые соответствуют цвету фона к белому, и устанавливает все остальные точки, черный.BitBlt использует передний план и цвет фона контекста устройства цветов для преобразования из цветов в монохромному.

Обратите внимание, что не все контексты устройства поддерживают BitBlt.Проверить, поддерживает ли заданный контекст устройства BitBlt, использующий функции-члена GetDeviceCaps и определяет индекс RASTERCAPS.