函式功能
函式功能:該函式從限定的執行檔;動態程式庫(DLL),或者圖示檔案中生成圖示句柄數組。
函式原型:UINT ExtractIconEx(LPCTSTR IpSZFile,int nlconlndex,HICON FAR*PhiCORLarge,HICON FAR'*phiconSmall,UINT nlcons);
參數說明
參數:
IpszFile:定義可獲取圖示的執行檔,DLL,或者圖示檔案的名字的空結束字元串指針。
nlconlndex:指定抽取第一個圖示基於零的變址;例如,如果該值是零;函式在限定的檔案中抽取第一圖示;如該值是C1且phlconLarge和phiconSmall參數均為NULL,函式返回限定檔案中圖示的總數;如果檔案是執行檔或DLL;返回值是RT_GROUP_ICON資源的數目;如果檔案是一個ICO檔案,返回值是1;在Windows95,WindowsNT4.0,和更高版本中,如果值為負數且phlconLarge和phiconSmall均不為NULL,函式從獲取圖示開始,該圖示的資源標識符等於nlconlndex絕對值。例如,使用-3來獲取資源標識符為3的圖示。
phiconLarge:指向圖示句柄數組的指針,它可接收從檔案獲取的大圖示的句柄。如果該參數是NULL沒有從檔案抽取大圖示。
phiconSmall:指向圖示句柄數組的指針,它可接收從檔案獲取的小圖示的句柄。如果該參數是NULL,沒有從檔案抽取小圖示。
nlcons:指定要從檔案中抽取圖示的數目。
返回值:如果nlconlndex參數是-1,PhiconLarge和PhiconSmall參數是NULL,返回值是包含在指定檔案中的圖示數目;否則,返回值是成功地從檔案中獲取圖示的數目。
備註:必須調用Destroylcon函式來清除由ExtractlconEx函式返回的圖示。為恢復大小圖示尺寸,可使用SM_CXICON,SM_CYICON,SM_CXSMICON,SM_CYSMICON標記來調用GetSystemMetrics函式。
Windows CE:nlconlndex參數必須是零或CN(N是指定的資源標識符);nlcons參數必須是1。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭檔案:shellspi.h;庫檔案:shell32.lib;Unicodg:在Windows NT上實現為Unicode和ANSI兩種版本。