Auswahl
Die Table-Komponente bietet verschiedene Auswahlmöglichkeiten. Es gibt Methoden zur Auswahl eines einzelnen Elements, mehrerer Elemente oder zur programmatischen Verwaltung von Auswahlen.
Für Informationen zur Verwendung des Repository-Mustes zur Verwaltung und Abfrage von Sammlungen siehe die Repository-Artikel.
Auswahlmodus
Der Auswahlmodus in der Tabelle bestimmt, wie Elemente vom Benutzer ausgewählt werden können. Es bietet Optionen zur Konfiguration des Verhaltens bei der Elementauswahl. Die Table-Klasse bietet eine Methode, um den Auswahlmodus festzulegen:
setSelectionMode(SelectionMode selectionMode)
Verfügbare Auswahlmodus-Optionen sind:
SINGLE- (Einzelauswahl)MULTI- (Mehrfachauswahl)NONE- (keine Auswahl).
Auswahlereignis
Das Table-Komponentenpaket erzeugt mehrere Ereignisse im Zusammenhang mit der Zeilenauswahl. Diese Ereignisse erfassen Änderungen im Auswahlstatus der Table-Zeilen. Nachfolgend sind die wichtigsten Auswahlereignisse zusammen mit ihren Beschreibungen aufgeführt:
TableItemSelectEvent- Wird ausgelöst, wenn ein Tabellenobjekt ausgewählt wird.TableItemDeselectEvent- Wird ausgelöst, wenn ein Tabellenobjekt abgewählt wird.TableItemSelectionChange- Wird ausgelöst, wenn sich die gesamte Auswahl in der Tabelle ändert oder wenn eine zusätzliche Auswahl getroffen wird.
Die TableItemSelectEvent- und TableItemDeselectEvent-Ereignisse werden nicht ausgelöst, wenn der Mehrfachauswahlmodus aktiv ist und die Auswahl über das Kontrollkästchen in der Kopfzeile erfolgt. In diesem Fall sollte stattdessen das TableItemSelectionChange verwendet werden.
Im folgenden Beispiel wird ein TableItemSelectEvent-Ereignis ausgelöst, wann immer ein Benutzer eine Zeile auswählt. Das Ereignis kann verarbeitet werden, indem ein Listener zur Tabelle mit der onItemSelect()-Methode hinzugefügt wird.
Auswahl per Kontrollkästchen
Die Auswahl über Kontrollkästchen ist aktiviert, wenn der Auswahlmodus MULTI ist, und ermöglicht es den Benutzern, bequem ein oder mehrere Elemente mithilfe von Kontrollkästchen auszuwählen, die mit jeder Zeile verbunden sind. Diese Funktion ist besonders nützlich für Szenarien, in denen Benutzer Massenaktionen an ausgewählten Elementen durchführen müssen. Die Table-Klasse bietet Methoden, um die Auswahl per Kontrollkästchen zu aktivieren und anzupassen.
Durch die Verwendung der Methode setCheckboxSelection(boolean checkboxSelection) können Kontrollkästchen so konfiguriert werden, dass sie neben jeder Zeile angezeigt werden, wodurch Benutzer Elemente auswählen können. Das folgende Programm zeigt die aktivierte Mehrfachauswahl und Auswahl per Kontrollkästchen:
Programmatische Auswahl
Die Table-Komponente bietet programmatische Auswahlanforderungen, mit denen Sie ausgewählte Elemente entweder über ihre Schlüssel oder über die gesamten Elemente manipulieren können.
Auswahl nach Schlüssel
Die Methode selectKey(Object... keys) ermöglicht es Ihnen, programmatisch Elemente mithilfe ihrer Schlüssel auszuwählen. Sie können dieser Methode einen oder mehrere Schlüssel übergeben, und sie wird die Auswahl entsprechend aktualisieren.
Auswahl von Elementeinstellungen
Schließlich ermöglicht die Methode select(T... items) eine programmatische Auswahl von Elementen, indem Sie ein oder mehrere Elemente selbst an diese Methode übergeben, um die Auswahl entsprechend zu aktualisieren.
Weiterlernen
ArtikelSpring Data JPA grid: sort, filter, and page in Java
ArtikelJava Data Grid: Build Fast, Sortable Tables with webforJ
ArtikelJava CRUD web app with Spring Boot and webforJ, step by step
ArtikelMulti-select in Java UI: ListBox and ChoiceBox with webforJ
ArtikelNatural language search for a Java table with webforJ
ArtikelJava web front end for a database: browse and edit