CreateBitmap

函數原型：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。