StretchBlt()函数

1. 原型及参数

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

x
目标矩形左上角的X逻辑坐标。 
y
目标矩形左上角的Y逻辑坐标。 
nWidth
目标矩形的宽度（逻辑单位）。 
nHeight
目标矩形的高度（逻辑单位）。 
pSrcDC
指定源设备上下文
xSrc
源矩形左上角的X逻辑坐标
ySrc
源矩形左上角的Y逻辑坐标 
nSrcWidth
源矩形的宽度（逻辑单位）
nSrcHeight

源矩形的高度（逻辑单位）

dwRop

指定要进行的光栅操作。光栅操作码定义了系统如何在输出操作中组合颜色，这些操作包括刷子、源位图和目标位图等对象。

2.返回值

     如果函数执行成功，那么返回值为非零，如果函数执行失败，那么返回值为零。Windows NT：若想获得更多的错误信息，请调用GetLastError函数。

3.【注意】：函数使用前要使用SetStretchBltMode函数，该函数可以设置指定设备环境中的位图拉伸模式。

函数原型：int SetSTretchBltMode(HDC hdc, int iStretchMode)；

参数：

hdc：设备环境句柄。

LStretchMode：指定拉伸模式。它可以取下列值，这些值的含义如下：

BLACKONWHITE：使用消除和现在的像素颜色值进行逻辑AND（与）操作运算。如果该位图是单色位图，那么该模式以牺牲白色像素为代价，保留黑色像素点。

COLORONCOLOR：删除像素。该模式删除所有消除的像素行，不保留其信息。

HALFTONE：将源矩形区中的像素映射到目标矩形区的像素块中，覆盖目标像素块的一般颜色与源像素的颜色接近。在设置完HALFTONE拉伸模之后，应用程序必须调用SetBrushOrgEx函数来设置刷子的起始点。如果没有成功，那么会出现刷子没对准的情况。

STRETCH_ANDSCANS：与BLACKONWHITE一样。

STRETCH_DELETESCANS：与COLORONCOLOR一样。

STRECH_HALFTONE：与HALFTONE相同。

STRETCH_ORSCANS：与WHITEONBLACK相同。

WHITEONBLACK：使用颜色值进行逻辑OR（或）操作，如果该位图为单色位图，那么该模式以牺牲黑色像素为代价，保留白色像素点。

返回值：如果函数执行成功，那么返回值就是先前的拉伸模式，如果函数执行失败，那么返回值为0。

Windows NT：若想获得更多错误信息，请调用GetLastError函数。

备注：拉伸模式在应用程序调用StretchBit函数时定义系统如何将位图的行或列与显示设备上的现有像素点进行组合。

BLACKONWHITE(STRETCH_ANDSCANS)和WHITEONBLACK(STRETCH_ORSCANS)模式典型地用来保留单色位图中的前景像素。COLORONCOLOR(STRETCH_DELETESCANS)模式则典型地用于保留彩色位图中的颜色。

HALFTONE模式比其他三种模式需要对源图像进行更多的处理，也比其他模式慢，但它能产生高质量图像，也应注意在设置HALFTONE模式之后，应调用SetBrushOrgEx函数以避免出现刷子没对准现象。