基本介紹
- 外文名:BOOL CDC::BitBlt()
- 含義:函式名
- 返回值:如果函式成功,那么返回值非零
- 平台:Windows
BOOL BitBlt( int x, 目標X坐標 int y, 目標Y坐標 int nWidth, 操作範圍寬度 int nHeight, 操作範圍高度 CDC* pSrcDC, 源內容 int xSrc, 源X坐標 int ySrc, 源Y坐標 DWORD dwRop 光柵操作方式);
下面列出了一些常見的光柵操作代碼:
BLACKNESS:表示使用與物理調色板索引0相關的色彩來填充目標矩形區域,(對預設的物理調色板而言,該顏色為黑色)。
DSTINVERT:表示使目標矩形區域顏色取反。
MERGECOPY:表示使用布爾類型的AND(與)操作符將源矩形區域的顏色與特定模式組合一起。
MERGEPAINT:通過使用布爾類型的OR(或)操作符將反向的源矩形區域的顏色與目標矩形區域的顏色合併。
NOTSRCCOPY:將源矩形區域顏色取反,再拷貝到目標矩形區域。
NOTSRCERASE:使用布爾類型的OR(或)操作符組合源和目標矩形區域的顏色值,然後將怕顏色取反。
PATCOPY:將特定的模式拷貝到點陣圖上。
PATPAINT:通過使用布爾OR(或)操作符將源矩形區域取反後的顏色值與特定模式的顏色合併。然後使用OR(或)操作符將該操作的結果與目標矩形區域內的顏色合併。
PATINVERT:通過使用XOR(異或)操作符將目標矩形區域內的顏色與特定模式的顏色合併。
SRCAND:通過使用AND(與)操作符將來源和目標矩形區域內的顏色合併。
SRCCOPY:將源矩形區域直接拷貝到目標矩形區域。
SRCERASE:通過使用AND(與)操作符將目標矩形區域顏色取反後與源矩形區域的顏色值合併。
SRCINVERT:通過使用布爾型的XOR(異或)操作符將源和目標矩形區域的顏色合併。
SRCPAINT:通過使用布爾型的OR(或)操作符將源和目標矩形區域的顏色合併。
WHITENESS:使用與物理調色板中索引1有關的顏色填充目標矩形區域。(對於預設物理調色板來說,這個顏色就是白色)。
返回值:如果函式成功,那么返回值非零;如果函式失敗,則返回值為零。
Windows NT:若想獲取更多的錯誤信息,請調用GetLastError函式。
備註:如果在源設備中可以實行旋轉或剪下變換,那么函式數BitBlt返回一個錯誤。如果存在其他變換(並且目標設備環境中匹配變換無效),那么目標設備環境中的區域將在需要時進行拉伸、壓縮或旋轉。
如果源和目標設備環境的顏色格式不匹配,那么BitBlt函式將源場景的顏色格式轉換成能與目標格式匹配的格式。當正在記錄一個增強型圖元檔案時,如果源設備環境標識為一個增強型圖元檔案設備環境,那么會出現錯誤。如果源和目標設備環境代表不同的設備,那么BitBlt函式返回錯誤。
Windows CE:在Windows CE 1.0版中,參數dwRop只可以指定為下列值:SRCCOPY,SRCAND,SRCPAINT,SRCINVERT。在Windows CE 2.0版中,參數dwRop可以是任何油印機操作代碼值。