选择

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) 方法使您能够通过键以编程方式选择项目。您可以将一个或多个键传递给此方法，它将相应地更新选择。

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