InstallShield內(nèi)部庫函數(shù)
1 庫函數(shù)綜述
InstallShield包含300多個內(nèi)部庫函數(shù)，用戶可在安裝腳本中調(diào)用它們來創(chuàng)建程序組，操作文件夾，處理目錄，監(jiān)督安裝狀態(tài)，創(chuàng)建對話框，操作文件及其它更多工作。因?yàn)镮nstallShield腳本編譯器已經(jīng)識別這些庫函數(shù)名，所以用戶在使用它們之前無須說明。
為了成功調(diào)用一個內(nèi)部庫函數(shù)，用戶必須知道庫函數(shù)名稱及使用格式。InstallShield 庫函數(shù)參閱附錄D庫函數(shù)索引。在接下去的幾節(jié)中我們將對其中主要的一些庫函數(shù)作詳細(xì)介紹。在這里先簡單向用戶描述一下庫函數(shù)的構(gòu)成。
如：AskYesNo是一個庫函數(shù)，它在對話框中顯示一個詢問，然后等待最終用戶通過點(diǎn)擊按扭來響應(yīng)，Yes或No。AskYesNo格式如下： AskYesNo(szQuestion,nDefault)。這個格式顯示了正確的函數(shù)名，括號中顯示了函數(shù)的參數(shù)列表。在函數(shù)的詳細(xì)說明幫助中，每個參數(shù)用匈牙利標(biāo)記法表示，指出每個參數(shù)位置上可被接受的數(shù)值類型。AskYesNo要求兩個參數(shù)：第一個是字符類型，第二個是數(shù)值型。
與C語言一樣，InstallShield區(qū)分大小寫，因此用戶要嚴(yán)格注意庫函數(shù)名稱中大寫字母。
在用戶的腳本中使用任何庫函數(shù)，傳遞的參數(shù)數(shù)目一定要正確，并且要確保傳遞的每個參數(shù)值符合該位置規(guī)定的類型。如果用戶傳遞了錯誤的參數(shù)數(shù)目或者在任何一個或幾個參數(shù)位置傳遞了不相符的數(shù)值類型，腳本都不能被編譯。
注意:
．作為參數(shù)傳遞的字符串必須包括在單引號或者雙引號內(nèi)。
如：“Please wait while files are transferred”，或‘This is a string’或“c:\Myfolder\myfile.txt”
．InstallShield 不允許將一個賦值語句作為參數(shù)傳遞。另外，用戶在一個函數(shù)變量中不能使用&&或||運(yùn)算符。
．由一個調(diào)用傳遞給一個函數(shù)的可變長字符串變量在被調(diào)用函數(shù)中不能自變長。如果函數(shù)試圖賦一個值，該值的長度超過參數(shù)的現(xiàn)有長度，則會發(fā)生401運(yùn)行錯誤。為避免這個錯誤，在調(diào)用將字符串傳遞給一個函數(shù)時就要為字符串指定一個特定長度。
2 用戶界面函數(shù)
用戶界面函數(shù)允許用戶自定義特定的錯誤信息及錯誤框標(biāo)題。然而，一些在安裝開發(fā)中遇到的內(nèi)部錯誤信息是不能由用戶界面函數(shù)來修改的。這部分主要對用戶界面函數(shù)的語法、描述、參數(shù)等作詳細(xì)說明。
2.1 Disable函數(shù)
語法：Disable(nConstant)
說明：Disable函數(shù)使由參數(shù)nConstant指定的用戶界面對象或安裝特性無效。
參數(shù)：
nConstant
指定用戶界面對象或可操作特性使其無效，在這個參數(shù)位置傳遞下列預(yù)定義常量之一：
BACKBUTTON：使在一些內(nèi)部對話框中顯示的Back按鈕無效（即使其變灰顯示），Back按鈕缺省置為有效。
BACKGROUND：使安裝主背景窗口無效且隱藏。注意：當(dāng)安裝處于全屏幕方式時該參數(shù)不起作用。
BILLBOARD：在安裝過程中取消布告板的顯示。
DIALOGCACHE：使對話緩沖機(jī)制無效。有關(guān)對話緩沖的詳細(xì)說明，請參閱Enable。
HOURGLASS：使光標(biāo)由一個“忙”光標(biāo)（缺省為沙漏光標(biāo)）改變?yōu)闃?biāo)準(zhǔn)光標(biāo)（缺省為一個指針）。
INDVFILESTATUS：使路徑及文件名在文件傳輸時不顯示在進(jìn)度指示器（狀態(tài)條）中。
LOGGING：不記錄卸載信息，使信息不記錄在卸載日志文件中。注意：記錄功能由函數(shù)DeinstallStart自動置為有效。在調(diào)用DeinstallStart
|
|
資源大�。�165.89 KB 
