共用方式為


CDC::BitBlt

複製來源裝置內容的點陣圖加入至目前的裝置內容。

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

參數

  • x
    指定目的端矩形左上角的邏輯 X 座標。

  • y
    指定目的端矩形左上角的邏輯 Y 座標。

  • nWidth
    指定寬度 (以邏輯單位 (Logical Unit) 的目的矩形和來源點陣圖。

  • nHeight
    指定高度 (以邏輯單位 (Logical Unit) 目的矩形和來源點陣圖。

  • pSrcDC
    out 識別裝置內容點陣圖複製至的 CDC 物件的指標。 它必須是 NULL ,如果 dwRop 指定不包含來源的光柵作業。

  • xSrc
    指定來源點陣圖的左上角的邏輯 X 座標。

  • ySrc
    指定來源點陣圖的左上角的邏輯 Y 座標。

  • dwRop
    指定要執行的光柵作業。 光柵作業程式碼定義 GDI 如何合併在涉及一個目前筆刷、一個可能的來源點陣圖和目的點陣圖的 I/O 作業的色彩。 提供 dwRop 及其描述的光柵作業程式碼清單查看 Windows SDK 的 BitBlt

如需光柵作業程式碼的完整清單,請參閱 Windows SDK的 如需光柵作業程式碼

傳回值

如果不是零,則函式成功,則為 0。

備註

應用程式可以對齊視窗或工作區與位元組界限確保 BitBlt 作業在位元組對齊的矩形時發生。 (集合 CS_BYTEALIGNWINDOWCS_BYTEALIGNCLIENT 旗標,當您註冊視窗類別)。

在位元組對齊的矩形的BitBlt 作業會在未對齊的位元組的矩形的 BitBlt 作業速度 如果您想要為裝置內容指定類別樣式 (例如位元組對齊,您必須註冊視窗類別而不是依賴 Microsoft Foundation Class 認可它。 使用全域函式 AfxRegisterWndClass

您可以使用目的裝置内容中,使用來源裝置內容, GDI 轉換 nWidth 和 nHeight,一次一次。 如果產生的程度不相符,使用 GDI 視窗 StretchBlt 函式視需要縮小或延伸來源點陣圖。

如果目的、來源和樣式點陣圖沒有相同的色彩格式, BitBlt 函式轉換來源和樣式點陣圖符合目的端。 目的點陣圖的前景和背景色彩來轉換。

BitBlt 函式轉換單色點陣圖色彩時,它會為白色位元 (1) 成與黑色 (0 位元) 的前景色彩。 使用目的裝置内容的前景和背景色彩。 會將色彩轉換為黑白相片, BitBlt 符合背景色彩為白色和設定其他像素為黑色像素的集合。 BitBlt 使用彩色裝置內容的前景和背景色彩會從色彩轉換為黑白相片。

請注意並不是所有的裝置內容 BitBlt支援。 確認指定的裝置內容是否支援 BitBlt,使用 GetDeviceCaps 成員函式並指定 RASTERCAPS 索引。

範例

CDC::CreateCompatibleDC。請參閱範例。

需求

Header: afxwin.h

請參閱

參考

CDC 類別

階層架構圖表

CDC::GetDeviceCaps

CDC::PatBlt

CDC::SetTextColor

CDC::StretchBlt

StretchDIBits

BitBlt