Selection
El componente Table proporciona diversas capacidades de selección. Existen métodos para seleccionar un solo ítem, varios ítems o gestionar selecciones de manera programática.
Para obtener información sobre cómo utilizar el patrón Repository para gestionar y consultar colecciones, consulte los artículos de Repository.
Modo de selección
El modo de selección en la tabla determina cómo los ítems pueden ser seleccionados por el usuario. Proporciona opciones para configurar el comportamiento de la selección de ítems. La clase Table proporciona un método para establecer el modo de selección:
setSelectionMode(SelectionMode selectionMode)
Las opciones de SelectionMode disponibles incluyen:
SINGLE- (selección única)MULTI- (selección múltiple)NONE- (sin selección).
Evento de selección
El paquete del componente Table emite varios eventos relacionados con la selección de filas. Estos eventos capturan cambios en el estado de selección de las filas de Table. A continuación se presentan los eventos de selección clave junto con sus descripciones:
TableItemSelectEvent- Emitido cuando un ítem de la tabla es seleccionado.TableItemDeselectEvent- Emitido cuando un ítem de la tabla es deseleccionado.TableItemSelectionChange- Emitido cuando la selección general en la tabla cambia o cuando se elige una selección adicional.
El TableItemSelectEvent y TableItemDeselectEvent no se activan cuando el modo de selección múltiple está activo y la selección se realiza a través de la casilla de verificación del encabezado. En este caso, se debe utilizar el TableItemSelectionChange.
En el ejemplo a continuación, se disparará un evento TableItemSelectEvent cada vez que un usuario seleccione una fila. El evento se puede manejar agregando un listener a la tabla utilizando el método onItemSelect().
Mostrar Código
- TableSingleSelectionView.java
- MusicRecord.java
- Service.java
Selección por casillas de verificación
La selección por casillas de verificación se habilita cuando el modo de selección es MULTI, y permite a los usuarios seleccionar cómodamente uno o más ítems utilizando las casillas de verificación asociadas a cada fila. Esta función es particularmente útil para escenarios en los que los usuarios necesitan realizar acciones en lotes sobre los ítems seleccionados. La clase Table proporciona métodos para habilitar y personalizar la selección por casillas de verificación.
Al utilizar el método setCheckboxSelection(boolean checkboxSelection), se pueden configurar las casillas de verificación para mostrarse junto a cada fila, permitiendo a los usuarios seleccionar ítems. El programa a continuación muestra la selección múltiple y la selección por casillas de verificación habilitadas:
Mostrar Código
- TableMultiSelectionView.java
- MusicRecord.java
- Service.java
Selección programática
El componente Table proporciona métodos de selección programática, permitiéndote manipular los ítems seleccionados ya sea por sus claves o por los ítems completos.
Seleccionar por clave
El método selectKey(Object... keys) te permite seleccionar programáticamente ítems utilizando sus claves. Puedes pasar una o más claves a este método, y actualizará la selección en consecuencia.
Seleccionar ítems de entrada
Finalmente, el método select(T... items) te permite seleccionar programáticamente ítems al pasar uno o más ítems a este método para actualizar la selección en consecuencia.