“单选按钮”用户界面对话框
“RadioButtons”对话框用于在安装过程中向用户显示最多四个互斥选项,并返回选定选项的值。 有三个“RadioButtons”对话框可用:“RadioButton (两个按钮)”、“RadioButton (三个按钮)”和“RadioButton (四个按钮)”。 这三个对话框除选项(单选)按钮的数目外其他完全相同;对每个部署项目每个对话框只能添加一次。
这些对话框包含两个、三个或四个具有关联标签的选项按钮,外加其他向用户提供信息的标签。 这些标签的文本是在设计时在**“属性”**窗口中指定的。 为每个选项按钮提供了附加属性以设置默认值和默认选项按钮。
下图显示典型的**“RadioButton (两个按钮)”**对话框,它与安装过程中显示的对话框一样。
“单选按钮”(两个按钮)对话框
属性
下列属性可用于**“RadioButtons”**对话框。
Property |
说明 |
---|---|
BannerBitmap |
指定显示在标题区中的位图或 JPEG 图像。 在上图中,显示的是默认位图。 有关更多信息,请参见 BannerBitmap 属性。 |
BannerText |
指定显示在标题区中的文本。 在上图中,这对应于“这里是标题栏文本”。 |
BodyText |
指定显示在选项按钮上的文本。 在上图中,这对应于“这里是正文文本”。 |
Button1Label |
指定显示在第一个选项按钮旁边的文本。 在上图中,这对应于“第一选项”。 |
Button1Value |
指定第一个选项按钮的值。 如果选定第一个选项按钮,这是将由 ButtonProperty 属性返回的值。 |
Button2Label |
指定显示在第二个选项按钮旁边的文本。 在上图中,这对应于“第二选项”。 |
Button2Value |
指定第二个选项按钮的值。 如果选定第二个选项按钮,这是将由 ButtonProperty 属性返回的值。 |
Button3Label |
指定显示在第三个选项按钮旁边的文本。 不可用于“RadioButton (两个按钮)”对话框。 |
Button3Value |
指定第三个选项按钮的值。 如果选定第三个选项按钮,这是将由 ButtonProperty 属性返回的值。 不可用于“RadioButton (两个按钮)”对话框。 |
Button4Label |
指定显示在第四个选项按钮旁边的文本。 不可用于“RadioButton (两个按钮)”或“RadioButton (三个按钮)”对话框。 |
Button4Value |
指定第四个选项按钮的值。 如果选定第四个选项按钮,这是将由 ButtonProperty 属性返回的值。 不可用于“RadioButton (两个按钮)”或“RadioButton (三个按钮)”对话框。 |
ButtonProperty |
指定用于检索选定选项按钮值的属性名。 此属性可在条件中使用。 |
DefaultValue |
指定显示对话框时最初选定的选项。 |
控制“单选按钮”对话框的外观
有若干属性控制**“RadioButtons”**对话框在安装过程中显示给用户的外观。
BannerBitmap 属性控制显示在对话框右上角的图像。 图像的位置和大小是固定的。
提示
为了保持用户界面的一致性,应当为安装程序中的所有对话框使用同一个图像。
BannerText 属性控制在对话框顶部的标题中显示的文本。 位置、大小和字体大小是固定的。 文本将换行,但不能多于两行。
BodyText 属性控制紧挨着对话框的标题部分下显示的文本。 位置、大小和字体大小是固定的。 文本将换行,但不能多于四行。
**“ButtonNLabel”**属性控制选项按钮标签中的文本。 位置和字体大小是固定的,而且文本不会换行。
提示
对于可本地化的对话框,应当为文本扩展留出额外的空间。 一种语言的某个词翻译为另一种语言时,长度可能会增加很多,从而导致文本被切断。
用“单选按钮”对话框属性检索用户选择
当包含**“RadioButtons”**对话框的安装程序运行时,用户可以选择选项;然后您可以利用该选择来控制安装的另一阶段。
例如,您可以创建一个**“RadioButton (两个按钮)”**对话框,向用户提供安装可选文件的选项。 在这种情况下,将 Button1Label 属性设置为“安装选项文件”,并将 Button2Label 属性设置为“不安装选项文件”。 将 Button1Value 和 Button2Value 属性分别保留为默认值 1 和 2。
如果认为用户通常不希望安装可选文件,可以将 DefaultValue 属性设置为 2,以便在默认情况下选中它。
在**“文件系统编辑器”中,将可选文件的“Condition”属性设置为“ButtonProperty”属性的默认值 (BUTTON2) 加上“Button1Value”**属性 (1):BUTTON2=1。
在安装过程中将计算文件的 Condition 属性。 如果用户选择第一个选项按钮,**“ButtonProperty”**属性将返回 Button1Value 并将安装文件;否则,条件的计算结果为 false,将不安装文件。