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