Selection
Le composant Table
fournit diverses capacités de sélection. Il existe des méthodes pour sélectionner un seul élément, plusieurs éléments ou gérer les sélections par programmation.
Mode de sélection
Le mode de sélection dans la table détermine comment les éléments peuvent être sélectionnés par l'utilisateur. Il offre des options pour configurer le comportement de la sélection des éléments. La classe Table fournit une méthode pour définir le mode de sélection :
setSelectionMode(SelectionMode selectionMode)
Les options disponibles pour SelectionMode incluent :
SINGLE
- (sélection unique)MULTI
- (sélection multiple)NONE
- (pas de sélection).
Événement de sélection
Le composant Table
émet plusieurs événements liés à la sélection de lignes. Ces événements capturent les changements dans l'état de sélection des lignes du Table
. Voici les principaux événements de sélection avec leurs descriptions :
TableItemSelectEvent
- Émis lorsqu'un élément de la table est sélectionné.TableItemDeselectEvent
- Émis lorsqu'un élément de la table est désélectionné.TableItemSelectionChange
- Émis lorsque la sélection globale dans la table change, ou lorsqu'une sélection supplémentaire est choisie.
Les événements TableItemSelectEvent
et TableItemDeselectEvent
ne sont pas déclenchés lorsque le mode de sélection multiple est actif et que la sélection est effectuée via la case à cocher de l'en-tête. Dans ce cas, TableItemSelectionChange
doit être utilisé à la place.
Dans l'exemple ci-dessous, un événement TableItemSelectEvent
sera déclenché chaque fois qu'un utilisateur sélectionne une ligne. L'événement peut être géré en ajoutant un écouteur à la table en utilisant la méthode onItemSelect()
.
Afficher le code
- Java
Sélection par case à cocher
La sélection par case à cocher est activée lorsque le mode de sélection est MULTI
, et permet aux utilisateurs de sélectionner facilement un ou plusieurs éléments à l'aide de cases à cocher associées à chaque ligne. Cette fonctionnalité est particulièrement utile pour les scénarios où les utilisateurs doivent effectuer des actions en masse sur les éléments sélectionnés. La classe Table fournit des méthodes pour activer et personnaliser la sélection par case à cocher.
En utilisant la méthode setCheckboxSelection(boolean checkboxSelection)
, les cases à cocher peuvent être configurées pour s'afficher à côté de chaque ligne, permettant ainsi aux utilisateurs de sélectionner des éléments. Le programme ci-dessous montre la sélection multiple et la sélection par case à cocher activées :
Afficher le code
- Java
Sélection programmatique
Le composant Table
fournit des méthodes de sélection programmatique, permettant de manipuler les éléments sélectionnés soit par leurs clés soit par les éléments eux-mêmes.
Sélection par clé
La méthode selectKey(Object... keys)
vous permet de sélectionner des éléments par programmation en utilisant leurs clés. Vous pouvez passer une ou plusieurs clés à cette méthode, et cela mettra à jour la sélection en conséquence.
Sélection par index
Utiliser la méthode selectIndex(int... indices)
vous permet de passer un ou plusieurs indices à la méthode et met à jour les éléments sélectionnés en conséquence.
Sélection d'éléments entiers
Enfin, la méthode select(T... items)
vous permet de sélectionner programmatique des éléments en passant un ou plusieurs éléments eux-mêmes à cette méthode pour mettre à jour la sélection en conséquence.