“复选框”用户界面对话框
使用**“复选框”对话框，可以在安装过程中向用户显示最多四个选项，并返回这些选项的值。 有三个“复选框”**对话框可用：“复选框 (A)”、“复选框 (B)”和“复选框 (C)”。 这三个对话框是相同的；对于每个部署项目，每个对话框只能添加一次。
这些对话框包含四个带关联标签的复选框，外加其他向用户显示信息的标签。 这些标签的文本是在设计时在**“属性”**窗口中指定的。 为每个复选框提供了控制可见性、设置默认值和返回一个值的附加属性。
下图显示了典型的**“复选框”**对话框，它与安装过程中显示的对话框一样。
“复选框”对话框
.gif "部署用户界面初始屏幕")
属性
下列属性可用于**“复选框”**对话框。
Property |
说明 |
|---|---|
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，将安装该文件；否则将不安装该文件。