3.5.2.1.29. 选项列表
API 文档

OptionsList 是 OptionsGroup 组件的变体，它将选项列表展示为可垂直滚动的列表。如果启用了多选，则可以通过单击时按住 Ctrl 键来选择多个选项，或按住 Shift 键来选择一个范围内的选项。

gui optionsList

该组件对应的 XML 名称： optionsList

默认情况下，OptionsList 组件在建议弹窗中显示第一个空元素，可以通过将 nullOptionVisible 属性设置为 false 来禁止此行为。

addDoubleClickListener() 会添加实现了 DoubleClickEvent 接口的监听器，用来拦截组件选项上的双击事件。

optionsList.addDoubleClickListener(doubleClickEvent ->
        notifications.create()
        .withCaption("Double clicked")
        .show());

同样，也可以订阅组件的双击事件的专有事件，示例：

@Subscribe("optionsList")
private void onOptionsListDoubleClick(OptionsList.DoubleClickEvent event) {
    notifications.create()
            .withCaption("Double clicked")
            .show();
}

OptionsList 和 OptionsGroup API 之间的区别是 OptionsList 没有 orientation 属性。

optionsList 的属性

align - caption - captionAsHtml - captionProperty - contextHelpText - contextHelpTextHtmlEnabled - css - datasource - description - descriptionAsHtml - editable - enable - box.expandRatio - height - icon - id - multiselect - nullOptionVisible - optionsDatasource - optionsEnum - property - required - requiredMessage - stylename - tabIndex - visible - width

optionsList 的元素

validator

API

addDoubleClickListener - addValueChangeListener - setContextHelpIconClickHandler - setOptionCaptionProvider