Selection
El componente Table proporciona diversas capacidades de selección. Hay métodos para seleccionar un solo elemento, múltiples elementos o gestionar las selecciones programáticamente.
Para obtener información sobre cómo utilizar el patrón Repository para gestionar y consultar colecciones, consulta los artículos de Repository.
Modo de selección
El modo de selección en la tabla determina cómo los elementos pueden ser seleccionados por el usuario. Proporciona opciones para configurar el comportamiento de la selección de elementos. 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 los 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 se selecciona un elemento de la tabla.TableItemDeselectEvent- Emitido cuando se deselecciona un elemento de la tabla.TableItemSelectionChange- Emitido cuando la selección general en la tabla cambia, o cuando se elige una selección adicional.
Los eventos 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 en su lugar TableItemSelectionChange.
En el ejemplo que se muestra a continuación, se disparará un evento TableItemSelectEvent cada vez que un usuario seleccione una fila. El evento puede ser manejado agregando un listener a la tabla utilizando el método onItemSelect().
Mostrar Código
- Java
Selección con casillas de verificación
La selección con 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 elementos utilizando casillas de verificación asociadas con cada fila. Esta característica es particularmente útil en escenarios en los que los usuarios necesitan realizar acciones masivas sobre elementos seleccionados. La clase Table proporciona métodos para habilitar y personalizar la selección con casillas de verificación.
Al utilizar el método setCheckboxSelection(boolean checkboxSelection), se pueden configurar las casillas de verificación para que se muestren junto a cada fila, permitiendo a los usuarios seleccionar elementos. El programa a continuación muestra la selección múltiple y la selección con casillas de verificación habilitadas:
Mostrar Código
- Java
Selección programática
El componente Table proporciona métodos de selección programática, lo que permite manipular elementos seleccionados ya sea por sus claves o por los elementos completos.
Seleccionar por clave
El método selectKey(Object... keys) te permite seleccionar programáticamente elementos utilizando sus claves. Puedes pasar una o más claves a este método, y actualizará la selección en consecuencia.
Seleccionar por índice
Utilizar el método selectIndex(int... indices) te permite pasar uno o más índices al método y actualizar los elementos seleccionados en consecuencia.
Seleccionando elementos completos
Finalmente, el método select(T... items) te permite seleccionar programáticamente elementos pasando uno o más elementos en sí mismos a este método para actualizar la selección en consecuencia.