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 键将焦点移动到此按钮组,请将其中一个按钮指定为该组的默认按钮。
验证