CDC::BitBlt

發行項
02/28/2013

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

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_BYTEALIGNWINDOW 或 CS_BYTEALIGNCLIENT 旗標，當您註冊視窗類別)。

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

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

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

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

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