multiSelectComboBox 多选下拉框
multiSelectComboBox
支持用户从下拉列表选择一项或多项。
该组件与 comboBox 类似。
-
XML 元素:
multiSelectComboBox
-
Java 类:
JmixMultiSelectComboBox
基本用法
当用户点击控件时可以打开下拉列表。使用键盘的上下键或者在控件中输入内容也可以打开下拉列表。

如需创建关联至数据的 multiSelectComboBox
,请使用 dataContainer 和 property xml 属性。itemsContainer 属性用于创建选项列表:
<data>
<instance class="com.company.onboarding.entity.User" id="userDc"> (1)
<fetchPlan extends="_base"> (2)
<property name="hobbies" fetchPlan="_base"/>
</fetchPlan>
<loader id="userDl"/>
</instance>
<collection class="com.company.onboarding.entity.Hobby" id="hobbiesDc"> (3)
<fetchPlan extends="_base"/>
<loader id="hobbiesDl">
<query>
<![CDATA[select e from Hobby e]]>
</query>
</loader>
</collection>
</data>
<layout>
<multiSelectComboBox dataContainer="userDc"
property="hobbies"
label="Hobbies"
itemsContainer="hobbiesDc"/> (4)
</layout>
1 | User 实体的 InstanceContainer 。 |
2 | 数据容器内部的实体fetch plan。 |
3 | Hobby 实体的 CollectionContainer 。 |
4 | multiSelectComboBox 使用 hobbiesDc 作为选项列表数据容器。 |
组件返回选择项目的列表。
XML 属性
id - allowCustomValue - allowedCharPattern - autoOpen - autofocus - classNames - clearButtonVisible - colspan - dataContainer - enabled - errorMessage - height - helperText - invalid - itemsContainer - itemsEnum - label - maxHeight - maxWidth - metaClass minHeight - minWidth - opened - placeholder - property - readOnly - required - requiredIndicatorVisible - tabIndex - themeNames - title - visible - width
事件和处理器
AttachEvent - BlurEvent - ClientValidatedEvent - ComponentValueChangeEvent - CustomValueSetEvent - DetachEvent - FocusEvent - TypedValueChangeEvent - itemLabelGenerator - validator
在 Jmix Studio 生成处理器桩代码时,可以使用 Jmix UI 组件面板的 Handlers 标签页或者视图类顶部面板的 Generate Handler 添加,也可以通过 Code → Generate 菜单(Alt+Insert / Cmd+N)生成。 |