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_BYTEALIGNWINDOW 或 CS_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