InstallShield内部库函数.doc

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：使安装主背景窗口无效且隐藏。注意：当安装处于全屏幕方式时该参数不起作用。 BILLBOARD：在安装过程中取消布告板的显示。 DIALOGCACHE：使对话缓冲机制无效。有关对话缓冲的详细说明，请参阅Enable。 HOURGLASS：使光标由一个“忙”光标（缺省为沙漏光标）改变为标准光标（缺省为一个指针）。 INDVFILESTATUS：使路径及文件名在文件传输时不显示在进度指示器（状态条）中。 LOGGING：不记录卸载信息，使信息不记录在卸载日志文件中。注意：记录功能由函数DeinstallStart自动置为有效。在调用DeinstallStart之前置记录卸载信息无效将不起任何作用，因为当DeinstallStart被调用时，记录功能将被自动激活，用户必须就在不应被记录的卸载操作执行之前手控禁止记录。 NEXTBUTTON：使一些内部对话框的Next按钮无效（使其变灰显示）。Next按钮缺省置为有效。 SELFREGISTERBATCH：使注册自注册文件的批处理方法无效。详细说明请参阅Enable。 SATAUS：使标准进展指示器（状态条）无效且隐藏。 STATUSDLG：使对话框形式的进展指示器（状态条）无效且隐藏。 STATUSEX：禁止以显示安装状态对话框来取代进度指示器（状态条）。 STATUSOLD：使原风格的进度指示器（状态条）无效且隐藏。 返回值： 0：说明函数成功禁止了由参数nConstant指定的用户界面对象或安装特性。 0：说明函数未能禁止由参数nConstant指定的用户界面对象或安装特性。 注解： ·如果用户的脚本中调用Disable函数来禁用Next或Back按钮，那么在函数被调用后的所有对话框中该按钮均被禁用，为激活Next或Back按钮，用户需带相应的常量来调用Enable。 ·DIALOGCACHE在没有Ne