函式功能
該函式創建一個新的 圖像(圖示、 游標、點陣圖)並複製該指定圖像的屬性到新的圖像。若有必要,該函式將伸展位值以填滿新圖像所需要的 尺寸。函式原型
HANDLE CopyImage(HANDLE hlmage,UjNT uTyPe,int cxDesired,int cyDesired,UINT fuFlags)基本參數
hImage:指向包含將被複製圖像的 模型中的一個特例的句柄。uType:說明被複製圖像的類型,此 參數將可能是如下值:
IMAGE_BITMAP:表示複製一個點陣圖;IMAGE_CURSOR;表示複製一個 游標。
IMAGE_ICON:表示複製一個圖示。
cxDesired:用來指定圖像所需的 像素寬度。
cyDesired:用來指定圖像所需的 像素高度。
fuFlags:指定下列複合值,其含義具體如下:
LR_COPYDELETEORG:表示創建一個副本後刪除原始圖像。
LR_COPYRETURNORG;表示創建一個圖像的精確副本,而忽略參數cxDesired和cyDesired。
LR_MONOCHROME:表示創建一個新的單色圖像。
LR_COPYFROMRESOURCE;表示試圖從原始資源檔案中再裝載圖示或游標資源而不是簡單的複製當前圖像。這使得在含有多種尺寸資源的資源檔案中再創建一個不同尺寸的副本時非常有用。若沒有這個標誌,Copylmage函式將伸展原始圖像到新的尺寸;若此標誌被設定,Copylmage函式將在 資源檔案中選擇使用最接近所期待尺寸的值。
此函式只有在 Loadlcon、 LoadCursor或Loadlmage函式中的hlmage參數被裝載成LR_SHARED值時才運行成功的。
返回值:如果函式運行成功,其值將返回最新創建圖像的句柄;如果函式運行失敗,其值將返回空。若想獲得更多的錯誤信息,請調用GetLastError函式。
注意:當使用完資源後,可以調用下表中列舉的函式以釋放相關記憶體。
Resource Release function資源釋放函式:Bitmap DeleteObject 點陣圖:DeleteObject;
Cursor DestroyCursor 游標:DestroyCursorr;lcon Destroylcon 圖示: Destroylcon。
當過程終止時,系統將自動刪除這些資源。因而,調用相關函式可以節省記憶體空間且減少過程工作設定所需空間的大小。
速查:Windows NT 3.5 Windows 95以上,頭檔案:winuserh; 庫檔案:user32.lib。