Skip to main content
Entwickler Themen
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Docking, Werkzeug- und Statusleisten

Mit Docking kann eine Anwendung mehrere Editoren oder Werkzeugansichten als Tabs öffnen. Benutzer können Tabs umsortieren, Gruppen teilen oder Inhalte in ein eigenes Fenster ziehen. Beim Verschieben bleibt derselbe JavaFX-Knoten erhalten. Die Anwendung kann daher weiter mit den bestehenden Bindings und dem aktuellen Bearbeitungszustand arbeiten.

Eine Arbeitsfläche einrichten

  1. Definiere benannte Zielbereiche mit DockLayout und DockGroupDefinition. Weise das Layout einem DockPane zu und setze den Pane in die Szene des Hauptfensters.
  2. Verbinde Fenster und Pane auf dem JavaFX Application Thread mit DockingManager.attach(stage, pane, new DockingOptions()).
  3. Öffne einen Dockable mit stabiler DockableId und einem vorhandenen JavaFX-Knoten. Mit DockTarget.area("editors") gibst du einen benannten Zielbereich an. Erneutes Öffnen derselben ID aktiviert den vorhandenen Tab. Zum Verschieben dient move.

DockPane lässt sich mit dem gewöhnlichen FXMLLoader laden. Eine bereits mit NeitzelLib geladene View kann ebenfalls als Inhalt dienen. Über activeDockableProperty() kann die Anwendung globale Befehle wie Speichern an den aktiven Editor richten. Ob ein Inhalt in eine Gruppe verschoben werden darf, lässt sich vor dem Anbinden über die Platzierungsregel festlegen.

Layout und Lebensdauer

Gruppen lassen sich teilen, einklappen oder als Overlay einrichten. Tabs lassen sich auch per Tastatur und Kontextmenü verschieben. Für asynchrone Schließentscheidungen kann die Anwendung zunächst Speichern, Verwerfen oder Abbrechen anbieten.

Ein Layout-Snapshot speichert die Anordnung mit stabilen IDs. Die Anwendung bestimmt den Speicherort und stellt beim Laden die Inhalte für diese IDs bereit. Eine Wiederherstellung erzeugt Inhalte für eine leere Arbeitsfläche. Ein Zurücksetzen der laufenden Arbeitsfläche kann vorhandene Editoren und ungespeicherte Änderungen erhalten. Beim Beenden kann die Anwendung die Zustimmung aller betroffenen Editoren einholen, das Layout sichern und erst danach die Fenster schließen.

Leisten mit und ohne Docking

Für die Werkzeugleiste genügt JavaFX ToolBar. Die NeitzelLib-Klasse de.neitzel.fx.control.StatusBar nimmt JavaFX-Knoten über getLeftItems() und getRightItems() auf. In FXML heißen die Eigenschaften leftItems und rightItems. Beide Controls lassen sich etwa oben und unten in einem BorderPane einsetzen und funktionieren auch ohne Docking oder MVVM.

Java- und FXML-Beispiele zum Nachbauen stehen im englischen Docking-Leitfaden und im Beispiel für die vollständige Arbeitsfläche.