对话框 (Windows Installer)
在 Dialog 表的 Dialog 列中指定对话框。 有关将对话框或广告牌添加到用户界面的详细信息,请参阅使用用户界面。
以下对话框名称由 Windows Installer 保留,不得用于任何由用户创作的自定义对话框。 安装程序要求使用以下保留名称在 Dialog 表中列出这些对话框。 每个对话框和名称只能列出一次。 开发人员必须在用户界面中创作这些对话框。 有关如何预览对话框的信息,请参阅导入用户界面。
对话框名称 | 对话框的简要说明 |
---|---|
FilesInUse 对话框 | 提醒用户处理文件的覆盖或删除。 |
FirstRun 对话框 | 收集用户名、公司名称和产品 ID。 |
MsiRMFilesInUse 对话框 | 提醒用户进程覆盖或删除文件,并为用户提供使用重启管理器关闭和重启应用程序的选项。 |
在安装过程中,某些事件会导致 Windows Installer 检查包中的用户界面序列表并显示指定的对话框。 例如,如果出现致命错误,Windows Installer 将在用户界面序列表中显示序列号为 -3 的对话框,而不考虑对话框在 Dialog 表中的名称。 下表列出了用户界面序列表中的特定事件及其对应的序列号:
事件类型 | 用户界面序列表序列号 | 对话框说明 |
---|---|---|
Fatal error | -3 | 安装因致命错误而终止。 |
用户出口 | -2 | 安装已根据用户请求而终止。 |
退出 | -1 | 安装已成功完成。 |
此外,包作者必须创建一个通用对话框以显示 Windows Installer 错误消息。 可以任意命名此对话框,但必须在 ErrorDialog 属性中指定此名称。
以下对话框是可选的,但通常会包含在安装包的创作用户界面中。 这些对话框是用于安装文件的大多数用户界面向导的典型对话框。 这些对话框可以在 Dialog 表中具有任何名称。 显示名称只是建议的做法,是为了清楚起见,可根据需要进行修改。 例如,可以在包中使用两个不同的自定义 LicenseAgreement 对话框,并在 Dialog 表中通过名称 ProfessionalLicenseAgreement 和 LimitedLicenseAgreement 进行区分。
对话框类型 | 对话框的简要说明 |
---|---|
DiskCost 对话框 | 指示用于安装的磁盘空间不足。 |
“浏览”对话框 | 允许用户选择目录。 |
取消对话框 | 确认终止安装的请求。 |
“许可协议”对话框 | 显示许可协议的模式框。 |
“选择”对话框 | 允许用户选择项的模式框。 |