InstallShield 内部库函数
1 库函数综述
InstallShield 包含 300 多个内部库函数,用户可在安装脚本中调用它们来创建程序组,
操作文件夹,处理目录,监督安装状态,创建对话框,操作文件及其它更多工作。因为
InstallShield 脚本编译器已经识别这些库函数名,所以用户在使用它们之前无须说明。
为了成功调用一个内部库函数,用户必须知道库函数名称及使用格式。InstallShield 库
函数参阅附录 D 库函数索引。在接下去的几节中我们将对其中主要的一些库函数作详细介
绍。在这里先简单向用户描述一下库函数的构成。
如:AskYesNo 是一个库函数,它在对话框中显示一个询问,然后等待最终用户通过点
击按扭来响应,Yes 或 No。AskYesNo 格式如下: AskYesNo(szQuestion,nDefault)。这个格
式显示了正确的函数名,括号中显示了函数的参数列表。在函数的详细说明帮助中,每个
参数用匈牙利标记法表示,指出每个参数位置上可被接受的数值类型。AskYesNo 要求两个
参数:第一个是字符类型,第二个是数值型。
与 C 语言一样,InstallShield 区分大小写,因此用户要严格注意库函数名称中大写字母。
在用户的脚本中使用任何库函数,传递的参数数目一定要正确,并且要确保传递的每
个参数值符合该位置规定的类型。如果用户传递了错误的参数数目或者在任何一个或几个
参数位置传递了不相符的数值类型,脚本都不能被编译。
注意:
.作为参数传递的字符串必须包括在单引号或者双引号内。
如:“Please wait while files are transferred”,或‘This is a string’或“c:\Myfolder\myfile.txt”
.InstallShield 不允许将一个赋值语句作为参数传递。另外,用户在一个函数变量中不能使
用&&或||运算符。
.由一个调用传递给一个函数的可变长字符串变量在被调用函数中不能自变长。如果函数
试图赋一个值,该值的长度超过参数的现有长度,则会发生 401 运行错误。为避免这个错
误,在调用将字符串传递给一个函数时就要为字符串指定一个特定长度。
2 用户界面函数
用户界面函数允许用户自定义特定的错误信息及错误框标题。然而,一些在安装开发
中遇到的内部错误信息是不能由用户界面函数来修改的。这部分主要对用户界面函数的语
法、描述、参数等作详细说明。
2.1 Disable 函数
语法:Disable(nConstant)
说明:Disable 函数使由参数 nConstant 指定的用户界面对象或安装特性无效。
参数:
nConstant
指定用户界面对象或可操作特性使其无效,在这个参数位置传递下列预定义常量之一:
BACKBUTTON:使在一些内部对话框中显示的 Back 按钮无效(即使其变灰显示),
Back 按钮缺省置为有效。
BACKGROUND:使安装主背景窗口无效且隐藏。注意:当安装处于全屏幕方式时该