RadioButton 表

单选按钮不被视为单个控件,但它们是用作 RadioButtonGroup 控件的单选按钮组的一部分。 RadioButton 表列出了所有组的按钮。

RadioButton 表包含以下列。

类型 密钥 Nullable
属性 Identifier Y N
订单 整数 Y N
格式化 N N
X 整数 N N
Y 整数 N N
宽度 整数 N N
高度 整数 N N
文本 格式化 N Y
帮助 文本 N Y

 

Property

要绑定到此单选按钮的命名属性。 绑定到同一属性的所有按钮都属于相同的组。

Order

一个正整数,用于确定一个列表中项的顺序。 不必是连续整数。

Value

与此按钮关联的值字符串。 选中按钮会将关联的属性设置为此值。

X

单选按钮边界矩形左上角的组中的水平坐标。 这必须是非负数。

Y

单选按钮边界矩形左上角的组中的垂直坐标。 这必须是非负数。

Width

按钮的宽度。 这必须是非负数。

Height

按钮的高度。 这必须是非负数。

Text

要分配给单选按钮的可本地化的可见标题。 如果文本太长,超出控件边界,则会将其截断。 如果按钮显示图标或位图,则此列包含图片的名称,它是 Binary 表中的键。 无法同时在按钮上显示图片和文本。

帮助

与按钮一起使用的帮助字符串。 这是可选文本,可本地化。 字符串由字符 (|) 分为两部分。 字符串的第一部分用作工具提示文本。 对于包含图片的控件,屏幕阅读器会显示此文本。 第二部分用于上下文相关帮助,不过上下文相关帮助尚未实现。 即使只存在这两种文本中一种,也需要分隔符。

备注

x、y、宽度和高度的整数值采用安装程序单位,而不是对话框单位。 安装程序单位等于 10 磅 MS Sans Serif 字号高度的十二分之一。 控件的坐标相对于标牌。

按钮的坐标是相对于组设定的。 如果更改组的坐标,组中的按钮彼此间的相对位置保持不变。

创建控件时,Value 和 Text 字段的内容被 MsiFormatRecord 函数格式化,因此它们能够包含 MsiFormatRecord 函数可解释的任何表达式。 仅在创建控件时进行格式化,如果在控件的生命周期内修改表达式中涉及的属性,不会更新该格式。

每个 RadioButtonGroup 控件与一个属性相关联。 此属性的默认值必须在 Property 表中初始化。 在 RadioButton 表中指定的每个 RadioButtonGroup 中,可能有一个单选按钮在 Value 字段中具有与此属性的默认值匹配的值。 这是 RadioButtonGroup 控件的默认按钮。 默认按钮最初在控件中是选中状态。

请注意,在选择组中的某个按钮之前,用户无法按 RadioButtonGroup 控件的 TAB 键来更改对话框中的焦点。 若要通过按 TAB 键将焦点移动到此按钮组,请将其中一个按钮指定为该组的默认按钮。

验证

ICE03
ICE06
ICE17
ICE34
ICE46