3.5.2.1.29. 选项列表

OptionsListOptionsGroup 组件的变体,它将选项列表展示为可垂直滚动的列表。如果启用了多选,则可以通过单击时按住 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();
}

OptionsListOptionsGroup API 之间的唯一区别是 OptionsList 没有 orientation 属性。