单选按钮

当要显示的项目较少时，可以使用“单选按钮”控件代替“下拉列表”控件。确保将唯一的项目绑定到控件。

可以使用数组填充“单选按钮”控件的选项。

常规

• “列表来源”- 要在多选下拉列表中显示的项目来源。有效的数据类型包括字符串数组、整数、日期时间、数据表或对象数组。
• “列”- 当列表来源的类型为“数据表”或“对象”数组时，选择特定列（适用于数据表数据类型）或特定属性（适用于对象数组）。
• “提示文本”- 要在 Runtime 显示的帮助文本。
• “默认选定值”- 要在 Runtime 显示的默认值。
• “工具提示”- 当应用程序用户将鼠标悬停在控件上时要显示的文本。使用此选项可提供有关控件的其他信息。
• “标签”- 控件的显示文本。
• “必需”- 如果为 True，则应用程序用户必须在控件中提供数据。要在 Runtime 将控件标记为必需，请在标签文本后添加星号 *。

• “自定义错误消息”- 当“必需”属性设置为 True 且控件留空时要显示的文本。

• 隐藏 - 如果为 true，则在 Runtime 隐藏该控件。

• “已禁用”- 如果为 True，则在 Runtime 禁用该控件。

Events

• “值已更改”- 配置在单选按钮值更改时会发生的情况。

样式

• “控件对齐”- 默认情况下，继承父级对齐方式。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式，请取消选择覆盖的选项。

  注意：对齐方式取决于为父元素选择的布局（垂直与水平）。
• “标签放置”- 默认情况下，标签设置为显示在控件顶部的左侧。您可以将其放置在控件的左侧同一行。“标签宽度”属性配置标签的宽度，“间距”属性设置标签和控件之间的距离。
• “布局”- 单选按钮选项的布局（垂直或水平）。默认情况下，它的设置为水平。“允许换行”属性用于将单选按钮换行为多行，而“间距”属性设置单选按钮选项之间的距离。
• “颜色”- 选中单选按钮时单选按钮的颜色。
• “背景颜色”- 控件的背景颜色。

• “字体”- 标签和输入文本的字体属性，例如字体系列、大小、颜色或样式（粗体、斜体和下划线）。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。

• “边距”- 控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。
• “大小”- 控件的宽度和高度。默认情况下，大小设置为 auto。要设置最小值或最大值，请单击三点图标 (...)。如果控件的大小小于选项的大小，则系统会显示滚动条。

VB 属性

VB 属性	数据类型	描述
工具提示	Apps.Controls.TabularInitClass	当用户将鼠标悬停在单选按钮上时显示的信息文本。
标签	字符串	单选按钮的标签，通常是显示在控件之前的文本。
SelectedItem	Apps.Controls.TabularInitClass	单选按钮的当前选择值。
数据源	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	单选按钮中值的数据源。
值	Apps.Controls.TabularInitClass	单选按钮的当前选择值。
必填	布尔值	指定单选按钮值是否为必填项。
RequiredErrorMessage	字符串	当该单选按钮的值为必填项但未提供时显示的消息。
隐藏	布尔值	确定单选按钮的可见性。 如果设置为 True，则在 Runtime 隐藏该控件。
已禁用	布尔值	确定单选按钮是否可交互。 如果设置为 True，则禁用在运行时与单选按钮的交互。
有效	布尔值	检查单选按钮值的有效性。 如果为 true，则表示它有效。