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