对话框 (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 对话框	指示用于安装的磁盘空间不足。
“浏览”对话框	允许用户选择目录。
取消对话框	确认终止安装的请求。
“许可协议”对话框	显示许可协议的模式框。
“选择”对话框	允许用户选择项的模式框。