# 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| --- | --- | --- |
| V6.0.1 | 新增了通过指令控制多选下拉列表选项是否禁用 | 2023-10-27 |
| V7.0.1 | 支持了多选下拉字段通过“选项显示方式”平滑切换为多选字段 | 2024-10-24 |
# 1 功能介绍
下拉选择内容的组件，多选。结合 字段布局面板 控件使用可以得到最佳的布局体验。
# 2 控件对象
`kd.bos.form.field.MulComboEdit`
# 3 视觉展示
# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
| 属性名 | 类型 | 默认值 | 说明 | 支持版本 |
| --- | --- | --- | --- | --- |
| 显示样式 | 下拉 | 文字 | 设置下拉项显示内容：文字、图片、文字+图片 | |
| 缺省值 | 多选下拉 | - | 设置多选下拉列表默认展示的下拉项 | |
| 下拉项 | 弹框选择 | - | 设置下拉字段下拉项信息，可配置标题，内容和图片 | |
| 为空提示信息 | 文本 | - | 当字段内容为空时，输入框内显示的信息 | |
| 已选项风格 | 下拉 | 文本 | 分为文本风格(text)和标签风格(label),选择标签风格时下拉项以标签形式展示，详见4.3.1 | |
| 校验下拉值 | 复选框 | false | 给下拉列表赋值时，校验此值是否在下拉列表中存在 | |
| 选项显示方式 | 下拉 | - | 可以通过控制该选项将多选下拉字段切换为多选字段 | V7.0.1 |
### 4.3.1 已选项风格
**已选项风格**属性分为文本风格、标签风格。风格视觉如下：
文本风格:
标签风格：
# 5 多选下拉列表接口介绍
## 5.1 控件编程模型
多选下拉框字段，派生自下拉框字段，与下拉框字段采用相同的控件编程模型[ComboEdit](https://vip.kingdee.com/knowledge/specialDetail/218022218066869248?category=218035423933468928&id=221555621978878208)。
ComboEdit可以控制下拉选项的锁定属性，kd.bos.form.field.ComboEdit#setComboItems 这个方法，该方法的入参是一个ComboItem集合，ComboItem提供了一个属性disable，代表是否可选，插件只需要调用控件的这个方法传入参数即可；
## 5.2 数据模型
多选下拉框的属性对象为MulComboProp类型，派生自ComboProp，存储下拉选项值，String类型：
```java
package kd.bos.entity.property;
public class MulComboProp extends ComboProp {
```
多选下拉框字段取值、赋值方法，与下拉框字段相同，多选下拉框可以选择多个选项，已选的多个选项值使用逗号”,”分割。
## 5.3 插件事件
多选下拉框字段，继承了字段值改变事件，未增加其他插件事件。
