BitBlt

該函數(shù)對指定的源設(shè)備環(huán)境區(qū)域中的像素進(jìn)行位塊（bit_block）轉(zhuǎn)換，以傳送到目標(biāo)設(shè)備環(huán)境。

原型：  

BOOL BitBlt(

  HDC hdcDest,

  int nXDest, int nYDest, int nWidth, int nHeight,

  HDC hdcSrc,

  int nXSrc, int nYSrc,

  DWORD dwRop)；

參數(shù)：   

hdcDest：指向目標(biāo)設(shè)備環(huán)境的句柄。

nXDest、nYDest：指定目標(biāo)矩形區(qū)域左上角的X軸和Y軸邏輯坐標(biāo)

nWidth、nHeight：指定源和目標(biāo)矩形區(qū)域的邏輯寬度和邏輯高度。

hdcSrc：指向源設(shè)備環(huán)境的句柄。

nXSrc、nYSrc：指定源矩形區(qū)域左上角的X軸和Y軸邏輯坐標(biāo)。

dwRop：指定光柵操作代碼。這些代碼將定義源矩形區(qū)域的顏色數(shù)據(jù)，如何與目標(biāo)矩形區(qū)域的顏色數(shù)據(jù)組合以完成最后的顏色。下面列出了一些常見的光柵操作代碼：

  完整的光柵操作(ROP)碼，參見 Ternary Raster Operations.

返回值：

   如果函數(shù)成功，那么返回值非零；如果函數(shù)失敗，則返回值為零。調(diào)用GetLastError函數(shù)獲取擴(kuò)展錯誤信息。

說明：

   如果在源設(shè)備環(huán)境中可以實行旋轉(zhuǎn)或剪切變換，那么函數(shù)BitBlt返回一個錯誤。

   如果存在其他變換（并且目標(biāo)設(shè)備環(huán)境中匹配變換無效），那么目標(biāo)設(shè)備環(huán)境中的矩形區(qū)域?qū)⒃谛枰獣r進(jìn)行拉伸、壓縮或旋轉(zhuǎn)。

   如果源和目標(biāo)設(shè)備環(huán)境的顏色格式不匹配，那么BitBlt函數(shù)將源場景的顏色格式轉(zhuǎn)換成能與目標(biāo)格式匹配的格式。

   當(dāng)正在記錄一個增強型圖元文件時，如果源設(shè)備環(huán)境標(biāo)識為一個增強型圖元文件設(shè)備環(huán)境，那么會出現(xiàn)錯誤。

   并不是所有的設(shè)備都支持BitBlt函數(shù)。更多信息，調(diào)用GetDeviceCaps 函數(shù)，將第二個參數(shù)賦值為RC_BITBLT來查看設(shè)備是否支持。(For more information, see the RC_BITBLT raster capability entry in the GetDeviceCaps function, as well as the MaskBlt and StretchBlt functions. )

   如果源和目標(biāo)設(shè)備環(huán)境代表不同的設(shè)備，那么BitBlt函數(shù)返回錯誤。

   更多關(guān)于從右到左向位塊傳輸顯示信息（For information about blitting to displays with right-to-left orientations），參見 Creating Bitmaps。

   在Windows CE 1.0和1.01版中，參數(shù)dwRop只可以指定為下列值：SRCCOPY、SRCAND、SRCPAINT、SRCINVERT。在Windows CE 2.0及以后版中，參數(shù)dwRop可以是任何ROP3代碼值。

 下面是MSDN上的例子：

HBITMAP CopyBitmap( HBITMAP hbm) {
  HDC hdcSrc = CreateCompatibleDC(NULL);
  HDC hdcDst = CreateCompatibleDC(NULL);
  HBITMAP hbmOld, hbmOld2, hbmNew;
  BITMAP bm;
  GetObject(hbm, sizeof(bm), &bm);
  hbmOld = SelectObject(hdcSrc, hbm);
  hbmNew = CreateBitmap( bm.bmWidth, bm.bmHeight, bm.bmPlanes,
    bm.bmBitsPixel,
    NULL);
  hbmOld2 = SelectObject(hdcDst, hbmNew);
  BitBlt(hdcDst, 0, 0, bm.bmWidth, bm.bmHeight, hdcSrc, 0, 0, SRCCOPY);
  SelectObject(hdcSrc, hbmOld);
  SelectObject(hdcDst, hbmOld2);
  DeleteDC(hdcSrc);
  DeleteDC(hdcDst);
  return hbmNew;
} 

如有疑問請留言或者到本站社區(qū)交流討論，感謝閱讀，希望能幫助到大家，謝謝大家對本站的支持！