LoadBitmap

LoadBitmap

LoadBitmap是從模組的執行檔中載入指定的點陣圖資源的函式。

該函式從模組的執行檔中載入指定的點陣圖資源,該函式已經被函式LoadImage替代。

基本介紹

  • 中文名:LoadBitmap
  • hlnstance:指向模組實例的句柄
  • lpBitmapName:指向字元串(以NULL結束)批指針
  • 返回值:函式執行成功指向指定點陣圖的句柄
  • 作用:載入點陣圖
函式簡介,參數,

函式簡介

函式功能:該函式從模組的執行檔中載入指定的點陣圖資源。該函式已經被函式LoadImage替代。
函式原型:HBITMAP LoadBitmap(HINSTANCE hInstance, LPCTSTR lpBitmapName);

參數

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_開始的所有值)。
Windows CE 1.0隻支持2位灰階調色板,所以只可以使用1位來表示每個像素(單色。BMP)或2位來表示每個像素(2bp)的點陣圖。

相關詞條

熱門詞條

聯絡我們