參數
BOOL StretchBlt(HDC hdcDest, int nXOriginDest, int nYOriginDest, int nWidthDest, int nHeightDest, HDC hdcSrc, int nXOriginSrc, int nYOriginSrc, int nWidthSrc, int nHeightSrc, DWORD dwRop);
hdcDest:指向目标設備環境的句柄。
nXOriginDest:指定目标矩形左上角的X軸坐标,按邏輯單位表示坐标。
nYOriginDest:指定目标矩形左上角的Y軸坐标,按邏輯單位表示坐标。
nWidthDest:指定目标矩形的寬度,按邏輯單位表示寬度。
nHeightDest:指定目标矩形的高度,按邏輯單位表示高度。
hdcSrc:指向源設備環境的句柄。
nXOriginSrc:指向源矩形區域左上角的X軸坐标,按邏輯單位表示坐标。
nYOriginSrc:指向源矩形區域左上角的Y軸坐标,按邏輯單位表示坐标。
nWidthSrc:指定源矩形的寬度,按邏輯單位表示寬度。
nHeightSrc:指定源矩形的高度,按邏輯單位表示高度。
dwRop:指定要進行的光栅操作。光栅操作碼定義了系統如何在輸出操作中組合顔色,這些操作包括刷子、源位圖和目标位圖等對象。參考BITBlt可了解常用的光栅操作碼列表。
下面列出了一些常見的光栅操作代碼:
BLACKNESS:表示使用與物理調色闆的索引0相關的色彩來填充目标矩形區域,(對缺省的物理調色闆而言,該顔色為黑色)。
DSTINVERT:表示使目标矩形區域顔色取反。
MERGECOPY:表示使用布爾型的AND(與)操作符将源矩形區域的顔色與特定模式組合一起。
MERGEPAINT:通過使用布爾型的OR(或)操作符将反向的源矩形區域的顔色與目标矩形區域的顔色合并。
NOTSRCCOPY:将源矩形區域顔色取反,再拷貝到目标矩形區域。
NOTSRCERASE:使用布爾類型的OR(或)操作符組合源和目标矩形區域的顔色值,然後将合成的顔色取反。
PATCOPY:将特定的模式拷貝到目标位圖上。
PATPAINT:通過使用布爾OR(或)操作符将源矩形區域取反後的顔色值與特定模式的顔色合并。然後使用OR(或)操作符将該操作的結果與目标矩形區域内的顔色合并。
PATINVERT:通過使用XOR(異或)操作符将源和目标矩形區域内的顔色合并。
SRCAND:通過使用AND(與)操作符來将源和目标矩形區域内的顔色合并。
SRCCOPY:将源矩形區域直接拷貝到目标矩形區域。
SRCERASE:通過使用AND(與)操作符将目标矩形區域顔色取反後與源矩形區域的顔色值合并。
SRCINVERT:通過使用布爾型的XOR(異或)操作符将源和目标矩形區域的顔色合并。
SRCPAINT:通過使用布爾型的OR(或)操作符将源和目标矩形區域的顔色合并。
WHITENESS:使用與物理調色闆中索引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軸左上角坐标;
Specifies the x-coordinate (in logical units) of the upper-left corner of the source rectangle.
nSrcWidth:源矩形寬度;
nSrcHeight:源矩形高度
dwRop:指定要進行的光栅操作。(和第一個函數一樣标示)
返回值
如果函數執行成功,那麼返回值為非零,如果函數執行失敗,那麼返回值為零。Windows NT:若想獲得更多的 錯誤信息,請調用GetLastError函數。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭文件:wingdi.h:庫文件:gdi32.lib。
說明
将源矩形中的位圖拷貝到目标矩形中,如果有必要,可以擴展或壓縮該位圖使其與目标矩形尺寸吻合。函數使用目标設備上下文(由SetStretchBltMode設置)的擴展模式來決定如何擴展或壓縮位圖。StretchBlt函數将pSrcDC源設備中的位圖移動到目标矩形,該矩形用成員函數正在調用的設備上下文來表示。xSrc,ySrc,nSrcWidth和nSrcHeight 參數定義了源矩形的左上角和尺寸。x,yc,nWidth和nHeight參數定義了目标矩形的左上角和尺寸。