函式功能:該函式創建與指定設備兼容的點陣圖,這種點陣圖是已淘汰的,它具有與設備一樣的位/像素格式和顏色調色板。應用程式可以選擇這種點陣圖作為與指定設備兼容的記憶體設備的當前點陣圖。
函式原型:HBITMAP CreateDiscardableBitmap(HDC hdc, int nWidth, int nHeight);
參數:
hdc:設備環境句柄。
nWidth:按位來指定點陣圖的寬度。
nHeight:按位來指定點陣圖的高度。
只有在應用程式沒有將由CreateDiscardableBitmap()函式創建的點陣圖選入顯示設備環境時,Windows才可以丟棄該點陣圖。當一個點陣圖未被選擇而由Windows丟棄後,應用程式試圖選擇該點陣圖,則CDC::SelectObject()函式將返回NULL。
當不再使用由CreateDiscardableBitmap()成員函式初始化的CBitmap對象後,要先將其選出設備環境,然後刪除該CBitmap對象。
返回值:如果函式執行成功,返回值是指向點陣圖的句柄;如果函式執行失敗,那么返回值為NULL。Windows NT:若想獲取更多錯誤信息,請調用GetLastError函式。