跳至主要内容

Selection

在 ChatGPT 中打开

Table组件提供了多种选择功能。可以选择单个项目、多个项目或以编程方式管理选择。

管理和查询数据

有关如何使用 Repository 模式管理和查询集合的信息，请参见Repository 文章。

选择模式​

表格中的选择模式决定了用户如何选择项目。它提供了配置项目选择行为的选项。Table 类提供了一个设置选择模式的方法：

setSelectionMode(SelectionMode selectionMode)

可用的 SelectionMode 选项包括：

  • SINGLE - （单个选择）
  • MULTI - （多个选择）
  • NONE - （无选择）。

选择事件​

Table 组件包会发出与行选择相关的多个事件。这些事件捕获 Table 行的选择状态变化。以下是关键选择事件及其描述：

  • TableItemSelectEvent - 当选择表项时发出。
  • TableItemDeselectEvent - 当取消选择表项时发出。
  • TableItemSelectionChange - 当表格中的整体选择发生变化时发出，或当选择了其他选择项时发出。
信息

当启用多重选择模式并通过表头复选框进行选择时，将不会触发 TableItemSelectEvent 和 TableItemDeselectEvent。在这种情况下，应该使用 TableItemSelectionChange。

在以下示例中，每当用户选择一行时，都会触发 TableItemSelectEvent 事件。可以通过使用 onItemSelect() 方法向表格添加监听器来处理该事件。

显示代码

复选框选择​

当选择模式为 MULTI 时，启用复选框选择，允许用户使用与每行关联的复选框方便地选择一个或多个项目。这一功能在用户需要对选定项目执行批量操作的场景中尤为有用。Table 类提供了启用和自定义复选框选择的方法。

通过使用 setCheckboxSelection(boolean checkboxSelection) 方法，可以配置在每行旁边显示复选框，从而允许用户选择项目。下面的程序显示了启用多重选择和复选框选择的示例：

显示代码

编程选择​

Table 组件提供了编程选择的方法，允许您通过键或整个项目来操作选定的项目。

通过键选择​

selectKey(Object... keys) 方法使您能够通过其键以编程方式选择项目。您可以将一个或多个键传递给此方法，并相应地更新选择。

通过索引选择​

使用 selectIndex(int... indices) 方法允许您将一个或多个索引传递给该方法，并相应地更新所选项目。

选择整个项目​

最后，select(T... items) 方法允许您通过将一个或多个项目本身传递给此方法以编程方式选择项目，以便相应地更新选择。