CDC::BitBlt

项目
03/01/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如何组合在涉及一个当前画笔、一个可能的源位图和一个目标位图的输出操作的颜色。为光栅操作代码的列表 dwRop 及其说明的参见。Windows SDK 的 BitBlt

有关完整的光栅操作代码，请参见。Windows SDK的有关光栅操作代码。

返回值

非零，如果函数运行成功;否则为0。

备注

应用程序可以对齐窗口或工作区(以字节为单位)界确保 BitBlt 操作在字节对齐的矩形发生。（设置 CS_BYTEALIGNWINDOW 或 CS_BYTEALIGNCLIENT 标志，在窗口类别的注册。）

在字节对齐的矩形BitBlt 操作比在不是对齐的字节的矩形 BitBlt 操作大量express。如果您要对设备上下文指定选件类样式(如字节对齐，则必须注册窗口选件类而不是依赖于Microsoft基础选件类执行断点。使用全局函数 AfxRegisterWndClass。

通过使用目标设备上下文，使用源设备上下文，GDI转换 nWidth 和 nHeight，一次一次。如果发生的区域不匹配，GDI使用Windows StretchBlt 功能根据需要压缩或拉伸源位图。

如果目标、源和模式位图没有相同颜色的格式，BitBlt 函数将源和模式位图匹配为目标。目标位图的前景色和背景色用于转换。

当 BitBlt 函数转换为单色位图转换为颜色时，它将空白位(1)为与黑色(0位)对前景色。使用目标设备上下文的前景色和背景色。若要将颜色为将照片，BitBlt 设置为与背景色设置为白色的像素和设置其他像素黑色。BitBlt 使用彩色设备上下文的前景色和背景色从彩色转换为将图片。

注意不是所有的设备上下文支持 BitBlt。若要检查特定设备上下文是否支持 BitBlt，请使用 GetDeviceCaps 成员函数并指定 RASTERCAPS 索引。