InstallShield内部库函数之4 内部对话框函数

InstallShield内部库函数之4  内部对话框函数
   下列函数创建简单对话框，如Yes/No对话框和消息框。一些函数允许你简单地显示公用对话框的各种类型。
有Cancel按扭的内部对话框当该按扭被选中时不返回CANCEL(2)值。而是调用当前定义的退出处理程序。
注意：作为缺省，InstallShield  Professional 6以Windows 2000 风格显示最终用户对话框，该风格遵照Windows用户界面的Microsoft的最新准则。为相应显示Windows 95风格的对话框，用户需做下列工作：
通过重命名或移至其它文件夹，将<InstallShield Professional 6文件夹>、Redistributable/Compressed Files/0009-English/Intel 32/_isres.dll备份。
将文件_isres.old 从<InstallShield Professional 6 文件夹>/Program/Migration/0009-English/Intel 32拷贝至<InstallShield Professional 6 文件夹>/Redistributable/compressed Files/0009-English/Intel 32。
改变文件名_isres.old为isres.dll。
单击建立工具栏Build toolbar'的建立当前媒体按钮Build Current Media或从建立菜单选择建立<媒体名称>媒体来建立用户的媒体。
具体函数包括以下这些：
AskDestPath
显示一个要求目标路径信息的对话框。
AskOptions
显示一个对话框，提示最终用户通过复选框或单选钮来选择选项。
AskPath
显示提示最终用户输入一个路径的对话框。
AskText
显示提示最终用户输入文本的对话框。
AskYesNo
显示一个对话框，提示最终用户通过点击Yes或No按扭来响应问题。
ComponentDialog
显示一个对话框，让最终用户选择组件和指定一个目标位置。
EnterDisk
显示一个对话框，提示最终用户一个指定的磁盘。
MessageBox
在对话框中显示一条信息。
RebootDialog
显示一个对话框，使最终用户可以选择重启Windows或重启计算机。
SelectDir
显示一个对话框，允许最终用户选择一个文件夹。当文件夹不存在时SelectDir创建该文件夹。
SelectDirEx
显示一个对话框，允许最终用户选择一个文件夹。
SelectFolder
显示一个对话框，允许最终用户从程序文件夹列表中选择一个文件夹。
SetupType
显示一个对话框，允许最终用户选择典型、简易、自定义安装。
SprintfBox
返回一个由一个或多个字符、数字或字符串值组成的格式化的字符串。
Welcome
显示欢迎信息的对话框。
4.1  AskDestPath
语法：AskDestPath (szTitle, szMsg, svDir, nReserved);
说明：AskDestPath函数显示一个对话框，允许最终用户指定安装中文件安装到的目标文件夹。对话框还包括一个浏览按扭，允许最终用户选择一个存在的文件夹或指定一个新的文件夹。注意最终用户选择的文件夹必须可写；不可写的文件夹不被接受。如果你希望最终用户可以选择不可写的文件夹，可调用AskPath函数。
    为从选择目标位置对话框中打开选择文件夹对话框，最终用户必须点击浏览(Browse)按钮。选择文件夹对话框显示所有有效文件夹列表。最终用户可选择一个存在的文件夹或者输入一个新的文件夹名。如果最终用户输入一个不存在的文件夹名，该文件夹被创建。
参数：
szTitle
指定对话框标题。为显示缺省标题（"选择目标位置"），传递一个空字符串给该参数。
szMsg
指定要显示的消息。为在该参数传递多行静态文字，在行需要间断处插入新行转换符序列（/n）。为显示该对话框的缺省指令，传递空字符串（""）给该参数。
svDir
指定打开对话框时显示的缺省路径；返回到达最终用户选择的文件夹的路径。更多信息请看下面的注解。
nReserved
该参数的值必须是0。
返回值：
NEXT (1)：表明Next按钮被选中。
BACK (12)：表明Back按钮被选中。
注解：
·如果由svDir指定的缺省文件夹不存在于最终用户系统中，它不会被创建，除非最终用户按下选择按钮并且从选择文件夹对话框中按步骤创建它。因此，当用户指定一个希望在调用ComponentTransferData(它在必要时会创建文件夹)前使用的缺省文件夹时，用户必须在AskDestPath返回时调用ExistDir以此来确定文件夹是否存在。如果它不存在，调用CreatDir来在最终用户系统中创建它。注意一个运行基于事件的脚本的安装程序会自动调用ComponentTransferData。
· 运行在静止方式（silent mode）的安装程序，若缺省文件夹不存在，则必须在调用AskDestPath前创建它。
4.2  AskOptions
语法：AskOptions (nValue, szMsg, szText1, bvCheck1, szText2, bvCheck2[, szTextn, bvCheckn] [,..., ]);
说明：AskOptiona 函数格式化并显示提示最终用户选择一个或多个选项的对话框。对话框的缺省标题是"选择组件"。为改变标题栏的内容，在调用AskOptions前调用SetDialogTitle。该对话框将显示多至九个选择控件，复选框或单选钮，根据nValue的值而定。
参数：
nValue
指定要显示的控件。在该参数位置传递下列预定义常量之一：
EXCLUSIVE：指定单选按钮，允许最终用户仅选择一个选项。
NONEXCLUSIVE：指定复选框，允许最终用户选择一个以上的选项。
szMsg
指定在对话框显示的消息。你可以使用该消息来描述选项和/或要求最终用户选择一个或多个选项。如果消息多于一行，使用换行符（/n）插入行的间隔处。
szText1
指定一个最多达47个字母的文本标签，它相邻显示于第一个复选框或单选钮。为建立一个快捷键，在用户为该目的指定的字母前插入一个"与符号"（&）。该字母带下划线显示来指示它的功能。例如，自定义Alt+C为快捷键，传递"&Custom"。自定义Alt+S为快捷键，传递"Cu&stom"。
bvCheck1
指定对话框打开时第一个选择框或单选钮的初始状态；对话框关闭时返回第一个选择框或单选钮的状态。在该参数位置传递下列常量：
TRUE：第一个选择框或单选钮被选。
FALSE：第一个选择框或单选钮未被选中。
szText2
指定相邻显示于第二个选择框/单选钮的最多达47个字母的文本标签。创建一个快捷键的方法同szText1处。
bvCheck2
指定对话框打开时第二个选择框或单选钮的初始状态；对话框关闭时返回第二个选择框或单选钮的状态。在该参数位置传递下列常量：
TRUE：第二个选择框或单选钮被选。
FALSE：第二个选择框或单选钮未被选。
    可以定义多达七个附加选项。每个附加选项由一对参数指示：一个字符串参数定义一个标签和一个数值型变量定义AskOptions返回时的选项状态。为设置一个选项的初始状态，在调用AskOptions前给数值型变量赋值为TRUE 或FALSE。
    若nValue是EXCLUSIVE并且一个以上的选项设置的初始状态设置为TRUE，AskOptions将预选设置为TRUE的参数序