Kapitel 8. Die Werkzeug-API von jadice 5

Einen Teil der Funktionen des ToolManagers haben wir oben bereits kennen gelernt, insbesondere diejenigen aus Sicht des Tools. Für die Integration stellt sich aber zunächst natürlich die Frage, wie auf ToolManager überhaupt zugegriffen werden kann, und welche Funktionen er bereitstellt.

ToolManager leben immer in enger Symbiose mit einer ViewComponent: Jeder ToolManager hat immer genau eine ViewComponent und jede ViewComponent hat immer einen ToolManager. Derzeit existieren zwei konkrete Implementierungen von ViewComponent: PageView und ThumbnailView. Der ToolManager einer ViewComponent kann mit ViewComponent.getToolManager() erfragt werden. Einige der häufigsten Idiome bei der Arbeit mit dem ToolManager sind im folgenden Code-Beispiel aufgeführt.

ViewComponent viewComponent = ...;

// Registrieren eines Tools
viewComponent.getToolManager().register(MyTool.class, true);

// Erfragen und Konfigurieren eines Tools
if(viewComponent.getToolManager().hasTool(MyTool.class))
  viewComponent.getToolManager().getTool(MyTool.class).setSomeOption(true);

// Aktivieren/Deaktivieren eines Tools
viewComponent.getToolManager().setEnabled(myTool.class, enabled);

// Deregistrieren eines Tools
viewComponent.getToolManager().deregister(MyTool.class);