# 1 功能介绍
单选按钮只能作为单选按钮组中的一个选项，不能独立使用。单选按钮组与单选按钮结合，构成一个完整的字段。
单选按钮组字段可定义多个选项，每个选项对应一个单选按钮。运行时，单选按钮组中选项之间互斥，只有一个选项能被选中。
单选按钮组字段存储选中的选项值，其功能与下拉框字段一致。即提供多个选项供用户选择，且选择一个。
# 2 控件对象
`kd.bos.form.field.ComboEdit`
# 3 视觉展示
* 默认风格
* 标签风格
# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
* 单选按钮
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 按钮值 | 文本 | 1 | 按钮代表的value |
| 组别 | 下拉 | - | 单选按钮所属的单选按钮组的标识 |
* 按钮组
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 缺省值 | 下拉 | - | 设置默认选中的单选按钮 |
| 字段风格 | 下拉 | 默认 | 设置按钮组风格：默认、标签，详情见4.3.1 |
| 下拉项 | 弹框选择 | - | 统一配置单选按钮值 |
| 校验下拉值 | 复选框 | false | 给按钮组赋值时，校验此值是否在按钮组中存在 |
### 4.3.1 字段风格
字段风格属性分别是默认、标签。视觉效果参考第3点。
# 5 插件示例
## 5.1 控件编程模型
单选按钮组字段派生自下拉框字段，与下拉框字段采用相同的控件编程模型[ComboEdit](https://vip.kingdee.com/article/229238321971860224)。
## 5.2 数据模型
单选按钮组字段的属性对象类型为ComboProp，与下拉框字段相同，存储已选的选项值，字段值类型为String。
## 5.3 插件事件
单选按钮组字段，继承了字段值改变事件，未增加其他插件事件。
# 6 注意事项
*按钮组 删除和新建：*
*1.新建单选按钮会判断单据内是否已经存在单选按钮组。 如果存在则自动关联，不存在则新建一个且自动关联。*
*2.单选按钮组不能单独删除，需要先关联一个单选按钮。删除单选按钮，按钮组将一并被删除。*
