CreateBitmap，創建一個帶有特定寬度、高度和顏色格式的點陣圖。
基本介紹
- 中文名：CreateBitmap
- 函式原型：HBITMAP CreateBitmap
- nWidth：定點陣圖寬度、單位為像素
- nHeight：指定點陣圖高度、單位為像素
函式資料,備註,
函式資料
函式原型：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。
