JavaFX für GUI-Entwicklung

TreeTableView in JavaFX: Baumstrukturen in Tabellen darstellen

Alle Videos des Tutorials JavaFX für GUI-Entwicklung
Denis Panjuta
Von Denis Panjuta Zuletzt aktualisiert am

Stell dir eine Tabelle vor, in der du einzelne Zeilen aufklappen kannst, sodass darunter weitere Einträge sichtbar werden, ähnlich wie Ordner im Dateiexplorer. Genau das leistet die TreeTableView in JavaFX. Sie kombiniert eine Tabelle mit einer Baumstruktur und eignet sich besonders für Daten mit Hierarchien, etwa Kategorien mit Unterpunkten, Projektstrukturen oder Organisationseinheiten.

JavaFX für GUI-Entwicklung – 27 TreeTableView

Das Video wird erst beim Abspielen von YouTube geladen – dabei werden Daten (u. a. deine IP-Adresse) an YouTube bzw. Google übertragen. Mehr dazu in der Datenschutzerklärung

In dieser Anleitung baust du Schritt für Schritt eine kleine TreeTableView auf. Du erstellst die Datenelemente, verknüpfst sie zu einem Baum, legst eine Tabellenspalte an und übergibst ihr die Inhalte. Zum Schluss fügst du alles in dein Benutzeroberfläche-Layout ein. Grundkenntnisse in Java und ein Grundverständnis der TreeView aus dem vorherigen Video helfen dir dabei, du brauchst aber keine Vorkenntnisse in Tabellen.

Wichtigste Erkenntnisse

  • Eine TreeTableView besteht aus einem Wurzelelement (TreeItem), darunterliegenden Kindelementen und mindestens einer TreeTableColumn.
  • Jede Spalte benötigt eine Zellwertfabrik (setCellValueFactory), die festlegt, welcher Wert in der Zelle angezeigt wird. Ohne sie bleibt die Spalte leer.
  • Mit root.setExpanded(true) werden die Kindelemente beim Start direkt sichtbar.
  • Die fertige Tabelle wird über getColumns().add(...) mit Spalten versorgt und anschließend in das Layout eingebunden.

Schritt-für-Schritt-Anleitung

Schritt 1: Datenelemente als TreeItems anlegen

Beginne damit, die Elemente zu erstellen, die später in deiner Tabelle erscheinen sollen. Jedes Element ist ein TreeItem<String>, also ein Baumelement, das eine Zeichenkette enthält. Im Beispiel heißt das erste Element „Element 1“. Du erzeugst es mit new TreeItem<>("Element 1") und speicherst es in einer Variablen, damit du es später verwenden kannst.

TreeItem<String> item1 = new TreeItem<>("Element 1");
TreeTableView in JavaFX: Baumstrukturen in Tabellen darstellen

Schritt 2: Weitere Elemente anlegen

Die Elemente zwei und drei entstehen auf die gleiche Weise. Am schnellsten gelingt das, indem du die Zeile kopierst und die Variablennamen sowie die Texte anpasst. Du erhältst so drei unabhängige Baumelemente, die noch nicht miteinander verbunden sind.

TreeItem<String> item2 = new TreeItem<>("Element 2");
TreeItem<String> item3 = new TreeItem<>("Element 3");

Schritt 3: Wurzelelement erstellen und aufklappen

Damit die drei Elemente eine Struktur bilden, brauchst du ein gemeinsames Wurzelelement. Lege es als TreeItem<String> mit dem Namen root an. Anschließend rufst du setExpanded(true) auf. Diese Methode sorgt dafür, dass die Kindelemente nach dem Start sichtbar sind und nicht eingeklappt bleiben.

TreeItem<String> root = new TreeItem<>("Root");
root.setExpanded(true);

Schritt 4: Kindelemente dem Wurzelelement hinzufügen

Nun verknüpfst du die Elemente mit der Wurzel. Über root.getChildren() greifst du auf die Liste der Kinder zu und fügst mit addAll alle drei Elemente auf einmal hinzu. Die Elemente befinden sich damit im Baum, allerdings existiert noch keine Tabellenspalte, die sie anzeigen könnte.

root.getChildren().addAll(item1, item2, item3);

Schritt 5: Tabellenspalte anlegen und benennen

Eine TreeTableView zeigt ihre Inhalte in Spalten an. Jede Spalte ist eine TreeTableColumn<String, String>. Der erste Typparameter gibt den Typ des Elements an, der zweite den Typ des angezeigten Werts. Beide sind hier String. Als Überschrift übergibst du beispielsweise den Text „Spalte“ an den Konstruktor.

TreeTableColumn<String, String> column = new TreeTableColumn<>("Spalte");

Schritt 6: Spaltenbreite festlegen

Damit die Inhalte vollständig lesbar sind, solltest du der Spalte eine feste Breite geben. Mit setPrefWidth(120) legst du eine bevorzugte Breite von 120 Pixeln fest. Diese Angabe ist ein Wunschwert, den das Layout bei Bedarf anpasst. Sie verhindert jedoch, dass die Spalte bei langen Texten nur wenige Zeichen zeigt.

column.setPrefWidth(120);

Schritt 7: Zellwertfabrik mit setCellValueFactory einrichten

An dieser Stelle entscheidet sich, ob die Spalte überhaupt Inhalte zeigt. Die Methode setCellValueFactory erwartet einen Callback, der für jede Zeile den anzuzeigenden Wert liefert. Ohne diesen Callback bleiben alle Zellen leer, egal wie viele Elemente im Baum stecken. Der Callback nimmt ein CellDataFeatures-Objekt entgegen, das Zugriff auf das jeweilige TreeItem gibt. Du kannst ihn als Lambda-Ausdruck formulieren.

TreeTableView in JavaFX: Baumstrukturen in Tabellen darstellen

Schritt 8: Lambda-Ausdruck mit ReadOnlyStringWrapper ausformulieren

Der Callback muss einen beobachtbaren Wert zurückgeben. Dafür eignet sich der ReadOnlyStringWrapper. In deinem Lambda-Ausdruck rufst du cellData.getValue() auf, um das TreeItem zu erhalten, und anschließend nochmals getValue(), um den eigentlichen String zu holen. Die Zeile lässt sich bei Bedarf umbrechen, damit der Code übersichtlicher bleibt.

column.setCellValueFactory(cellData ->
        new ReadOnlyStringWrapper(cellData.getValue().getValue()));

Schritt 9: Benötigte Klassen importieren

Damit der Code kompiliert, musst du die verwendeten Klassen importieren. Dazu gehören TreeItem, TreeTableView, TreeTableColumn und ReadOnlyStringWrapper. Achte darauf, bei den Spalten die Variante für TreeTableColumn und nicht die für die normale TableColumn zu wählen. Beide tragen ähnliche Namen, und ein falscher Import führt zu Typfehlern.

import javafx.beans.property.ReadOnlyStringWrapper;
import javafx.scene.control.TreeItem;
import javafx.scene.control.TreeTableColumn;
import javafx.scene.control.TreeTableView;
TreeTableView in JavaFX: Baumstrukturen in Tabellen darstellen

Schritt 10: TreeTableView erstellen und mit der Wurzel verbinden

Jetzt erstellst du die eigentliche Tabelle. Sie erhält den Typ String, und im Konstruktor übergibst du das Wurzelelement root. Die Tabelle weiß dadurch, welcher Baum angezeigt werden soll.

TreeTableView<String> treeTable = new TreeTableView<>(root);

Schritt 11: Spalte zur Tabelle hinzufügen und ins Layout einbinden

Die Spalte fügst du über getColumns().add(column) der Tabelle hinzu. Eine Tabelle kann mehrere Spalten besitzen, deshalb ist diese Liste der richtige Ort dafür. Anschließend platzierst du die TreeTableView in deinem bestehenden Layout, beispielsweise in einem GridPane, indem du sie mit add an der gewünschten Position einfügst.

treeTable.getColumns().add(column);

Schritt 12: Anwendung starten und Ergebnis prüfen

Starte die Anwendung. Du solltest nun eine Tabellenspalte mit der Überschrift „Spalte“ sehen. Darunter erscheinen das Wurzelelement „Root“ und die drei Kindelemente. Da du setExpanded(true) gesetzt hast, sind die Unterelemente direkt sichtbar. Falls die Spalte leer bleibt, prüfe zuerst, ob du den Callback aus Schritt 7 gesetzt hast, und danach, ob die Spalte tatsächlich mit getColumns().add hinzugefügt wurde.

TreeTableView in JavaFX: Baumstrukturen in Tabellen darstellen

Zusammenfassung – TreeTableView in JavaFX: Baumstrukturen in Tabellen darstellen

Mit der TreeTableView kombinierst du Baumstrukturen und Tabellenspalten in einem Steuerelement. Du legst zuerst die TreeItem-Elemente an, verknüpfst sie über ein Wurzelelement und erstellst anschließend die Spalten. Die setCellValueFactory-Methode ist dabei entscheidend, weil sie die Anzeige der Werte steuert. Mit getColumns().add übergibst du die Spalten an die Tabelle, die du danach in dein Layout einbindest. Im nächsten Video geht es um den HTML-Editor, mit dem du weitere interessante Oberflächen gestalten kannst.

FAQ

Muss ich die TreeTableView immer mit einem Wurzelelement erstellen?Ja, der Konstruktor erwartet ein TreeItem als Wurzel, auch wenn du nur wenige Elemente anzeigen möchtest.

Warum bleibt meine Spalte leer, obwohl die Elemente im Baum vorhanden sind?Vermutlich fehlt die Zellwertfabrik. Setze mit setCellValueFactory einen Callback, der den anzuzeigenden Wert liefert.

Was bewirkt setExpanded(true)?Es sorgt dafür, dass die Kindelemente des Wurzelelements beim Start sichtbar sind und nicht eingeklappt bleiben.

Warum muss ich TreeTableColumn statt TableColumn verwenden?Eine TreeTableView arbeitet mit hierarchischen Daten und benötigt deshalb die passende Spaltenklasse. Eine normale TableColumn passt nicht zu einem TreeItem.

Kann ich mehrere Spalten in einer TreeTableView anzeigen?Ja, füge einfach weitere TreeTableColumn-Objekte mit getColumns().add hinzu.

Wozu dient der ReadOnlyStringWrapper?Er verpackt den String in ein beobachtbares, nur lesbares Objekt, das die Zelle für die Anzeige benötigt.

Denis Panjuta
Trainer Über Denis Panjuta Hi! Ich bin Denis Panjuta und habe einen Bachelor in Wirtschaftsingenieurswesen der HTWG Konstanz, wo ich auch meine Begeisterung fürs Programmieren entdeckte. Zurzeit lernen bereits über 16.000 Studenten von meinen Kursen. Alle Kurse von Denis Panjuta