函式資料
函式原型:HBITMAP CreateBitmap(int nWidth,int nHeight, UINT cPlanes, UINT cBitsPeral,CONST VOID *lpvBits);
參數:
nWidth:指定點陣圖寬度、單位為像素。
nHeight:指定點陣圖高度、單位為像素。
CPlanes:指定該設備使用的顏色位面數目。
CBitsPerPel:指定用來區分單個像素點顏色的位數(比特數目)。
LpvBits:指向顏色數據數組指針。這些顏色數據用來設定矩形區域內像素的顏色。矩形區域中的每一掃描線必須是雙位元組的整數倍(不足部分以0填充)。如果該參數為NULL,將不對新生成的點陣圖進行初始化。
返回值:如果函式成功,那么返回值是點陣圖的句柄;如果失敗,那么返回值為NULL。若想獲取更多錯誤信息,請調用GetLastError函式。
備註
在創建完點陣圖之後,可以通過使用SeletObject函式把它選入到設備環境中。儘管函式CreateBitmap可以用來創建彩色點陣圖,但由於性能方面的原因,應用程式使用CreateBitmap函式來創建單位色點陣圖,創建彩色點陣圖應該使用函式CreateCompatibleBitmap。當由CreateBitmap創建而返回的彩色點陣圖被選入到設備環境時,系統必須確保選入進去的設備環境格式與點陣圖匹配。由於函式CreateCompatibleBitmap獲取設備環境,所以它返回的點陣圖與指定的設備環境有相同的格式。由於這個原因,對SelectObject的後續調用都要比從CreateBitmap函式創建返回的彩色點陣圖調用快。
如果點陣圖是單色的,那么對於目標設備環境而言,0表示前景顏色,而1表示背景顏色。
如果應用程式將nWidth或nHeight參數設為0,那么函式CreateBitmap返回的是只有一個含像素的單色點陣圖的句柄。當不再需要點陣圖時,可調用DeleteObject函式刪除它。
Windows CE:參數cPlanes必須是1。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭檔案:wingdi.h;庫檔案:gdi32.lib。