-
LoadBitmap
鎖定
LoadBitmap是從模塊的可執行文件中加載指定的位圖資源的函數。
該函數從模塊的可執行文件中加載指定的位圖資源，該函數已經被函數LoadImage替代。
- 中文名
- LoadBitmap
- hlnstance
- 指向模塊實例的句柄
- lpBitmapName
- 指向字符串（以NULL結束）批指針
- 返回值
- 函數執行成功指向指定位圖的句柄
- 作 用
- 加載位圖
LoadBitmap函數簡介
函數原型：HBITMAP LoadBitmap(HINSTANCE hInstance, LPCTSTR lpBitmapName)；
LoadBitmap參數
hlnstance：指向模塊實例的句柄。該模塊的可執行文件包含了要加載的位圖。
lpBitmapName：指向字符串（以NULL結束）批指針。該字符串包含了要加載的位圖資源名稱。另外一種方式就是該參數可以由低位字是資源標識符、高位字為0位形式組成。可以使用宏MAKEINTRESOURCE來創建這個參數值。
返回值：如果函數執行成功，則返回值是指向指定位圖的句柄。如果函數執行失敗，那麼返回值是NULL。
Windows NT：若想獲取更多錯誤信息，請調用GetLastError。
備註：如果由參數lpBitmapName指向的位圖不存在，或者沒有足夠的內存來加載該位圖，則函數失敗。應用程序可以使用函數LoadBitmap來訪問Win32 API使用的，預定義的位圖。若要這麼做，應用程序必須將hlnstance參數設為NULL，並且lpBitmapName參數應取下列值：
OBM_BTNCORNERS OBM_OLD_RESTORE; OBM_BTSIZE OBM_OLD_RGARROW;
OBM_CHECK OBM_OLD_UPARROW; OBM_OLD_RESTORE; OBM_OLD_ZOOM;
OBM_CLOSE OBM_REDUCE; OBM_COMBO OBM_REDUCED; OBM_DNARROW
OBM_RESTORE; OBM_LFARROWD OBM_RGARROW1; OBM_LFARROW1
OBM_SIZE; OBM_MNARROW OBM_UPARROW; OBM_OLD_CLOSE OBM_UPARROWD;
OBM_OLD_DNARROW OBM_PARROW1; OBM_OLD_LFARROW OBM_ZOOM;
OBM_OLD_REDUCE OBM_ZOOMD
以OBM_OLD開頭的位圖名錶示是比3.0 更早的16位版Windows系統使用的位圖。
對於使用任何OBM_常量的應用程序而言，在加入WINDOWS.H頭文件之前必須定義常量OEMRESOURCE。
應用程序必須調用DeleteObject函數來刪除LoadBitmap函數返回的每一個位圖句柄。
對於Windows CE：當使用LoadBitmap函數時位圖進行初始化時，該位圖是隻讀的。當把位圖選入到設備環境中時，無法更改設備環境（例如，加入文字），因為這樣需要往位圖寫入的權利。
Windows CE不支持參數lpBitmapName中的OBM_*（以OBM_開始的所有值）。
