“复选框”用户界面对话框

2008-09-04

更新：2007 年 11 月

使用“复选框”对话框，可以在安装过程中向用户显示最多四个选项，并返回这些选项的值。有三个“复选框”对话框可用：“复选框 (A)”、“复选框 (B)”和“复选框 (C)”。这三个对话框是相同的；对于每个部署项目，每个对话框只能添加一次。

这些对话框包含四个带关联标签的复选框，外加其他向用户显示信息的标签。这些标签的文本是在设计时在“属性”窗口中指定的。为每个复选框提供了控制可见性、设置默认值和返回一个值的附加属性。

下图显示了典型的“复选框”对话框，它与安装过程中显示的对话框一样。

“复选框”对话框

部署用户界面初始屏幕

属性

下列属性可用于“复选框”对话框。

属性	说明
BannerBitmap	指定显示在标题区中的位图或 JPEG 图像。在上图中，显示的是默认位图。有关更多信息，请参见 BannerBitmap 属性。
BannerText	指定显示在标题区中的文本。在上图中，这对应于“这里是标题栏文本”。
BodyText	指定显示在复选框上方的文本。在上图中，这对应于“这里是正文文本”。
Checkbox1Label	指定显示在第一个复选框旁边的文本。在上图中，这对应于“第一选择”。
Checkbox1Property	指定用于检索第一个复选框的值（“Checked”或“Unchecked”）的属性名称。此属性可在条件中使用。有关更多信息，请参见条件部署。
Checkbox1Value	指定第一个复选框的初始值（“Checked”或“Unchecked”）。
Checkbox1Visible	指定第一个复选框是可见还是隐藏。对于显示一个或多个复选框的对话框，此属性应设置为 true。
Checkbox2Label	指定显示在第二个复选框旁边的文本。在上图中，这对应于“第二选择”。
Checkbox2Property	指定用于检索第二个复选框的值（“Checked”或“Unchecked”）的属性名称。此属性可在条件中使用。有关更多信息，请参见条件部署。
Checkbox2Value	指定第二个复选框的初始值（“Checked”或“Unchecked”）。
Checkbox2Visible	指定第二个复选框是可见还是隐藏。对于显示两个或更多个复选框的对话框，此属性应设置为 true；对于显示单个复选框的对话框，此属性应设置为 false。
Checkbox3Label	指定显示在第三个复选框旁边的文本。在上图中，这对应于“第三选择”。
Checkbox3Property	指定用于检索第三个复选框的值（“Checked”或“Unchecked”）的属性名称。此属性可在条件中使用。有关更多信息，请参见条件部署。
Checkbox3Value	指定第三个复选框的初始值（“Checked”或“Unchecked”）。
Checkbox3Visible	指定第三个复选框是可见还是隐藏。对于显示三个或更多个复选框的对话框，此属性应设置为 true；对于显示两个或更少的复选框的对话框，此属性应设置为 false。
Checkbox4Label	指定显示在第四个复选框旁边的文本。在上图中，这对应于“第四选择”。
Checkbox4Property	指定用于检索第四个复选框的值（“Checked”或“Unchecked”）的属性名称。此属性可在条件中使用。有关更多信息，请参见条件部署。
Checkbox4Value	指定第四个复选框的初始值（“Checked”或“Unchecked”）。
Checkbox4Visible	指定第四个复选框是可见还是隐藏。对于显示四个复选框的对话框，此属性应设置为 true；对于显示三个或更少的复选框的对话框，此属性应设置为 false。

控制“复选框”对话框的外观

有若干个属性控制“复选框”对话框在安装过程中显示给用户的外观。

BannerBitmap 属性控制显示在对话框右上角的图像。图像的位置和大小是固定的。

提示：

为了保持用户界面的一致性，应当为安装程序中的所有对话框使用同一个图像。
BannerText 属性控制在对话框顶部的标题中显示的文本。位置、大小和字体大小是固定的。文本将换行，但不能多于两行。
BodyText 属性控制紧挨着对话框的标题部分下显示的文本。位置和字体大小是固定的。文本将换行，但不能多于四行。

提示：
为了保持用户界面的一致性，应当为安装程序中的所有对话框使用同一个图像。

“CheckboxNLabel”属性控制复选框标签中的文本。位置、大小和字体大小是固定的，而且文本不会换行。

提示：
对于可本地化的对话框，应当为文本扩展留出额外的空间。一种语言的某个词翻译为另一种语言时，长度可能会增加很多，从而导致文本被切断。

用“复选框”对话框属性检索用户选择

当包含“复选框”对话框的安装程序运行时，用户可以更改任何可见复选框的值；然后您就可以利用该选择来控制安装的另一阶段。

例如，可以创建一个“复选框”对话框，向用户提供安装两个可选文件（“文件 A”和“文件 B”）的选项。在这种情况下，将“Checkbox1Label”属性设置为“安装文件 A”，将“Checkbox2Label”属性设置为“安装文件 B”。因为只需要两个复选框，所以还应将“Checkbox3Visible”和“Checkbox4Visible”属性设置为 false。

如果认为用户通常希望安装文件 A，可以将“Checkbox1Value”属性设置为“Checked”，以便在默认情况下选中该复选框。

在“文件系统编辑器”中，将文件 A 的“Condition”属性设置为“Checkbox1Property”属性的值，将文件 B 的“Condition”属性设置为“Checkbox2Property”属性的值。

安装过程中将计算每一个文件的 Condition 属性。如果用户选中该复选框，条件的计算结果将为 true，将安装该文件；否则将不安装该文件。