CDC::PlgBlt
在來源裝置內容執行位元的位元區塊傳輸色彩資料從指定之矩形加入至指定的平行四邊形中指定的裝置內容。
BOOL PlgBlt(
LPPOINT lpPoint,
CDC* pSrcDC,
int xSrc,
int ySrc,
int nWidth,
int nHeight,
CBitmap& maskBitmap,
int xMask,
int yMask
);
參數
lpPoint
物件的陣列會指向識別目的平行四邊形的三個角落的邏輯空間的三個點。 來源矩形的左上角是對應至陣列中的第一個點，則第二點的右上角陣列中與第三點的左下角。 來源矩形的右下角會對應至平形四邊形的隱含第四點。pSrcDC
識別來源裝置內容。xSrc
以邏輯單位指定 X 座標，，來源矩形的左上角。ySrc
以邏輯單位指定 Y 座標，，來源矩形的左上角。nWidth
以邏輯單位指定寬度，，來源矩形。nHeight
以邏輯單位指定高度，，來源矩形。maskBitmap
識別用來遮罩來源矩形的色彩的選擇性單色點陣圖。xMask
指定單色點陣圖的左上角的 X 座標。yMask
指定單色點陣圖的左上角的 Y 座標。
傳回值
如果不是零，則函式成功，則為 0。
備註
如果指定的位元遮罩控制代碼識別有效單色點陣圖，函式會使用此點陣圖位元遮罩從來源矩形的色彩資料。
平行四邊形 (D) 的第四個頂點是藉由將前三個點定義而成 (A， B 和 C) 做為向量和計算 D = + B C - A。
如果這個位元遮罩存在，值為 1 表示遮罩指示應該複製來源像素色彩加入目的。 值為 0 表示遮罩指示不要變更目的端像素的色彩。
如果遮罩矩形小於來源和目的矩形，函式會複製掩模圖表檔案。
縮放、轉譯和反映轉換在來源裝置內容允許;不過，旋轉和切變轉換不是。 如果遮罩點陣圖不是單色點陣圖，則會發生錯誤。 如果有需要，目的裝置内容的自動縮放 (Stretch) 模式用來決定如何自動縮放或壓縮像素。 當一個加強型中繼檔記錄時，就會發生錯誤，如果來源裝置內容識別加強型中繼檔 (Metafile) 裝置內容。
目的座標以目的裝置内容中被轉換，來源座標以來源裝置內容被轉換。 如果來源轉換具有旋轉或剪貼簿，就會傳回錯誤。 如果目的和來源矩形沒有相同的色彩格式， PlgBlt 轉換來源矩形符合目的矩形。 並非所有的裝置支援 PlgBlt。 如需詳細資訊，請參閱 RC_BITBLT 光柵 (Raster) 功能的描述。 CDC::GetDeviceCaps 成員函式的。
如果來源和目的裝置内容中表示不相容的裝置， PlgBlt 傳回錯誤。
需求
Header: afxwin.h