InstallShield6.22 AddFolderIcon使用注意事項
AddFolderIcon
szCommandLine, szWorkingDir,
szIconPath, nIcon, szShortCutKey, nFlag);
當添加圖示到Windows NT下的組時,首先調用ProgDefGroupType來确定組為公用還是專用。預設時,檔案夾圖示添加為公用。
參數:
szProgramFolder
指定将圖示添加至的檔案夾的名稱。如果該檔案夾不存在,InstallShield建立它。
為添加圖示到具體的檔案夾,指定全限定路徑,如:
"C:\\WINDOWS\\STARTMENU\\PROGRAMS\\ACCESSORIES\\GAMES".
FOLDER_DESKTOP:将圖示添加到桌面檔案夾。
FOLDER_STARTUP:将圖示添加到啟動菜單檔案夾。
FOLDER_PROGRAMS:将圖示添加到開始菜單\程式檔案夾。
你也可以指定一個相對于一個由InstallShield系統變量辨別的檔案夾的路徑,例如,
FOLDER_PROGRAMS ^ "ACCESSORIES\\GAMES"
指定要添加到檔案夾的圖示名。該名将顯示在圖示下面。在Windows 95及更高版本下,調用AddFolderIcon添加一個圖示到一個程式檔案夾時,也在由szCommandLine指定的連結目錄中建立一個連結檔案。注意開發人員外殼不允許在項目名中有下列字元:/, \, :, ?, <, >, 或 |。
szCommandLine
指定下列情況之一:
95及更高版本的開始程式菜單,輸入一個連結目錄的全限定路徑,在那兒你的應用程式存放了它的圖示連結檔案。
全限定路徑,如果szItemName是一個子檔案夾 。(僅對Windows 95及更高版本、Windows NT 4.0)。
szWorkingDir
指定應用程式檔案所在的目錄。(如果szItemName是一個子檔案夾則不适用)。為使得包含程式檔案的目錄為工作目錄,給該參數傳遞一個空字元串(“”)。不要調用LongPathToQuote來把該路徑包圍(括)在引号中。更多資訊請檢視下面的注解部分。
szIconPath
定要顯示的圖示的全限定檔案名。(如果szItemName是一個子檔案夾則不适用)。不要調用LongPathToQuote來把該路徑包圍(括)在引号中。更多資訊請檢視下面的注解部分。
nIcon
指定Windows中由szIconPath指定的可執行檔案的的圖示序号。(如果szItemName是一個子檔案夾則不适用)。圖示序号數從0開始,是以為顯示可執行檔案的第一個圖示,指定0;為顯示第二個,指定1,如此繼續。如果你不使用一個Windows圖示,給該參數指定0。
szShortCutKey
指定快捷鍵(以字元串形式),允許最終使用者迅速啟動應用程式。例如,如果你想要能通過按下”Ctrl”,”Alt”然後”1”鍵來打開應用程式,則給該參數傳遞”Ctrl+Alt+1”。 如果szItemName是一個子檔案夾則不适用)。
nFlag
REPLACE:表明檔案夾中的目前圖示或項目被置換。
RUN_MAXIMIZED:表明程式被裝入時必須被最大化。
RUN_MINIMIZED:表明程式被裝入時必須被最小化。
NULL:表明沒有選項。
傳回值:
0:表明函數成功添加或置換指定檔案夾中的圖示并使可執行檔案和圖示相關聯。
< 0:表明函數沒有能添加或置換指定檔案夾中的圖示并使可執行檔案和圖示相關聯。
注解:
·不要調用LongPathToQuote來得到作為參數szWorkingDir 和 szIconPath的表達式。InstallShield自動将這些路徑括在引号中。
圖示路徑szIconPath卻不需要用引号括起來;