AutoHideToolbar für Java Swing

vorhergehende Artikel in: Java Komponenten sQLshell
16.11.2024

Ich habe eine neue Java Swing Komponente erstellt: Es handelt sich um einen Wrapper für von JToolBar abgeleitete Klassen, die die Werkzeugleiste minimieren und sie nur dann einblenden, wenn der Mauszeiger über ihnen schwebt.

Da es in der GUI für die sQLshell sehr gedrängt zugeht, habe ich in letzter Zeit bei der Weiterentwicklung der Lösung darauf geachtet, dem Anwender möglichst viel Raum zu geben bzw die Elemente der GUI so weit möglich flexibel anordnen zu können.

In diesem Sinne entstand eine weitere Komponente: die AutoHideToolbar. Das ist ein Wrapper, der jede Instanz einer von JToolBar abgeleitete Klassen - und natürlich auch Instanzen von JToolBar selbst - aufnehmen kann. Die daraus entstehende Komponente wird an der Stelle in der GUI eingegliedert, die die Werkzeugleiste normalerweise einnehmen würde. Sie ist verglichen mit der Werkzeugleiste aber sehr schmal - erst, wenmn der Anwender den Mauszeiger über ihr positioniert wird die eigentliche Werkzeugleiste eingeblendet und der Anwender kann ganz normal mit ihr interagieren. Verlässt der Mauszeiger das Gebiet der Werkzeugleiste, wird sie nach einer bestimmten Zeitspanne (Voreinstellung: 1 Sekunde) wieder durch die platzsparendere Komponente ersetzt.

Damit die Bedienoberfläche trotzdem noch intuitiv bleibt wird auf der platzsparenden Komponente ein Bild der Werkzeugleiste produziert - damit ist es für den Anwender leichter, die Gebiete der GUI zu identifizieren, wo sich Werkzeugleisten verbergen.

Die folgenden Beispiele zeigen die Bedienoberfläche der sQLshell mit und ohne Einsatz dieser Komponente:

Screenshot Bedienoberfläche der sQLshell mit mehreren Werkzeugleisten

Screenshot Bedienoberfläche der sQLshell mit ausgeblendeten Werkzeugleisten

Der Code der Komponente:

/*
 * Copyright (c) 2024.
 *
 * Juergen Key. Alle Rechte vorbehalten.
 *
 * Weiterverbreitung und Verwendung in nichtkompilierter oder kompilierter Form,
 * mit oder ohne Veraenderung, sind unter den folgenden Bedingungen zulaessig:
 *
 *    1. Weiterverbreitete nichtkompilierte Exemplare muessen das obige Copyright,
 * die Liste der Bedingungen und den folgenden Haftungsausschluss im Quelltext
 * enthalten.
 *    2. Weiterverbreitete kompilierte Exemplare muessen das obige Copyright,
 * die Liste der Bedingungen und den folgenden Haftungsausschluss in der
 * Dokumentation und/oder anderen Materialien, die mit dem Exemplar verbreitet
 * werden, enthalten.
 *    3. Weder der Name des Autors noch die Namen der Beitragsleistenden
 * duerfen zum Kennzeichnen oder Bewerben von Produkten, die von dieser Software
 * abgeleitet wurden, ohne spezielle vorherige schriftliche Genehmigung verwendet
 * werden.
 *
 * DIESE SOFTWARE WIRD VOM AUTOR UND DEN BEITRAGSLEISTENDEN OHNE
 * JEGLICHE SPEZIELLE ODER IMPLIZIERTE GARANTIEN ZUR VERFUEGUNG GESTELLT, DIE
 * UNTER ANDEREM EINSCHLIESSEN: DIE IMPLIZIERTE GARANTIE DER VERWENDBARKEIT DER
 * SOFTWARE FUER EINEN BESTIMMTEN ZWECK. AUF KEINEN FALL IST DER AUTOR
 * ODER DIE BEITRAGSLEISTENDEN FUER IRGENDWELCHE DIREKTEN, INDIREKTEN,
 * ZUFAELLIGEN, SPEZIELLEN, BEISPIELHAFTEN ODER FOLGENDEN SCHAEDEN (UNTER ANDEREM
 * VERSCHAFFEN VON ERSATZGUETERN ODER -DIENSTLEISTUNGEN; EINSCHRAENKUNG DER
 * NUTZUNGSFAEHIGKEIT; VERLUST VON NUTZUNGSFAEHIGKEIT; DATEN; PROFIT ODER
 * GESCHAEFTSUNTERBRECHUNG), WIE AUCH IMMER VERURSACHT UND UNTER WELCHER
 * VERPFLICHTUNG AUCH IMMER, OB IN VERTRAG, STRIKTER VERPFLICHTUNG ODER
 * UNERLAUBTE HANDLUNG (INKLUSIVE FAHRLAESSIGKEIT) VERANTWORTLICH, AUF WELCHEM
 * WEG SIE AUCH IMMER DURCH DIE BENUTZUNG DIESER SOFTWARE ENTSTANDEN SIND, SOGAR,
 * WENN SIE AUF DIE MOEGLICHKEIT EINES SOLCHEN SCHADENS HINGEWIESEN WORDEN SIND.
 *
 */

package de.elbosso.ui.components.container;

import javax.swing.*; import java.awt.*; import java.awt.event.ActionEvent; import java.awt.event.ComponentEvent; import java.awt.event.MouseEvent; import java.awt.image.BufferedImage; import java.beans.PropertyChangeEvent;

public class AutoHideToolbar extends javax.swing.JPanel implements java.awt.event.MouseListener ,java.awt.event.ActionListener ,java.awt.event.AWTEventListener ,java.beans.PropertyChangeListener ,java.awt.event.ComponentListener { private final javax.swing.JLabel l=new javax.swing.JLabel(); private final javax.swing.JToolBar tb; private javax.swing.Timer timer; private int delay; //milliseconds

public AutoHideToolbar(javax.swing.JToolBar tb) { this(tb,1000); } public AutoHideToolbar(javax.swing.JToolBar tb, int delay) { super(new java.awt.BorderLayout()); this.tb=tb; this.delay=delay; l.setBorder(javax.swing.BorderFactory.createEmptyBorder(1,1,1,1)); add(tb); tb.addComponentListener(this); }

@Override public void addNotify() { super.addNotify();

}

public javax.swing.JToolBar getToolBarComponent() { return tb; }

private void stopTimer() { if (timer != null) { timer.stop(); timer=null; } }

private void reTriggerTimer() { if(timer!=null) { timer.stop(); timer.restart(); } else { timer=new javax.swing.Timer(delay, this); timer.start(); } }

@Override public void mouseEntered(MouseEvent e) { if (e.getSource() == l) { removeAll(); add(tb); updateVisuals(); if(l.getIcon()==null) { java.awt.Dimension d = tb.getPreferredSize(); if (tb.getOrientation() == SwingConstants.HORIZONTAL) { paintImage(d.width, 5, 0, -(d.height - 5) / 2); } else { paintImage(5, d.height, -(d.width - 5) / 2, 0); } } Toolkit.getDefaultToolkit().addAWTEventListener(this, AWTEvent.MOUSE_EVENT_MASK); } else if(e.getSource()==tb) { stopTimer(); } }

private void updateVisuals() { getParent().invalidate(); getParent().validate(); getParent().doLayout(); getParent().repaint(); }

@Override public void mouseExited(MouseEvent e) { if(e.getSource()==tb) { reTriggerTimer(); } }

@Override public void actionPerformed(ActionEvent e) { Toolkit.getDefaultToolkit().removeAWTEventListener(this); removeAll(); add(l); updateVisuals(); }

@Override public void eventDispatched(AWTEvent event) { if((getComponent(0)==tb)&&(tb.isVisible())) { java.awt.event.MouseEvent me=(java.awt.event.MouseEvent)event; java.awt.Point p=tb.getLocationOnScreen(); java.awt.Rectangle rect=new java.awt.Rectangle(p.x,p.y,tb.getWidth(),tb.getHeight()); if(rect.contains(me.getLocationOnScreen())) { stopTimer(); } else { reTriggerTimer(); } } }

@Override public void propertyChange(PropertyChangeEvent evt) { if(AutoHideToolbarSwitch.getSharedInstance().isEnabled()) { Toolkit.getDefaultToolkit().removeAWTEventListener(this); tb.addMouseListener(this); configurationChanged(); add(l); updateVisuals(); } else { tb.removeMouseListener(this); Toolkit.getDefaultToolkit().removeAWTEventListener(this); configurationChanged(); add(tb); updateVisuals(); } } private void configurationChanged() { stopTimer(); removeAll(); }

private void paintImage(int imgWidth, int imgHeight, int transX, int transY) { if(tb.isShowing()) { java.awt.image.BufferedImage bimg = new java.awt.image.BufferedImage(imgWidth, imgHeight, BufferedImage.TYPE_INT_ARGB); java.awt.Graphics2D g2 = bimg.createGraphics(); g2.translate(transX, transY); tb.paint(g2); g2.dispose(); l.setIcon(new ImageIcon(bimg)); } } @Override public void componentResized(ComponentEvent e) { tb.removeComponentListener(this); java.awt.Dimension d=tb.getPreferredSize(); if(tb.getOrientation()== SwingConstants.HORIZONTAL) { paintImage(d.width, 5, 0, -(d.height - 5) / 2); } else { paintImage(5,d.height, -(d.width - 5) / 2,0); } removeAll(); l.setOpaque(true); setOpaque(tb.isOpaque()); setBackground(tb.getBackground()); l.addMouseListener(this); if(AutoHideToolbarSwitch.getSharedInstance().isEnabled()) { tb.addMouseListener(this); add(l); } else { add(tb); } AutoHideToolbarSwitch.getSharedInstance().addPropertyChangeListener(this); }

@Override public void componentMoved(ComponentEvent e) { //Intentionally left blank }

@Override public void componentShown(ComponentEvent e) { //Intentionally left blank }

@Override public void componentHidden(ComponentEvent e) { //Intentionally left blank } @Override public void mouseClicked(MouseEvent e) { //Intentionally left blank }

@Override public void mousePressed(MouseEvent e) { //Intentionally left blank }

@Override public void mouseReleased(MouseEvent e) { //Intentionally left blank } }

Alle Artikel rss Wochenübersicht Monatsübersicht Codeberg Repositories Mastodon Über mich home xmpp


Vor 5 Jahren hier im Blog

  • Multi-User-WebDAV, Docker, GitHub

    17.11.2019

    Nachdem ich mich in letzter Zeit verstärkt mit Docker und dem zugehörigen Ökosystem beschäftige, habe ich begonnen, verschiedenste Dienste in Containern zu testen um zu sehen, ob in manchen Fällen LXC oder KVM nicht doch die bessere Wahl wäre...

    Weiterlesen...

Neueste Artikel

  • Migration der Webseite und aller OpenSource Projekte

    In eigener Sache...

    Weiterlesen...
  • Integration von EBMap4D in die sQLshell

    Ich habe bereits in einem früheren Artikel über meine ersten Erfolge berichtet, der sQLshell auf Basis des bestehenden Codes aus dem Projekt EBMap4D eine bessere Integration für Geo-Daten zu spendieren und entsprechende Abfragen, bzw. deren Ergebnisse auf einer Kartenansicht zu visualisieren.

    Weiterlesen...
  • Gif-Animationen in Java

    Nachdem ich neulich auf einen sehr interessanten Link gestoßen war, habe ich mich dafür interessiert, ob es möglich wäre - und falls ja: wie einfach - GIF-Animationen aus Java heraus zu erzeugen - und zwar mit Bordmitelln und ohne Zuhilfenahme externer Biblioheken

    Weiterlesen...

Manche nennen es Blog, manche Web-Seite - ich schreibe hier hin und wieder über meine Erlebnisse, Rückschläge und Erleuchtungen bei meinen Hobbies.

Wer daran teilhaben und eventuell sogar davon profitieren möchte, muss damit leben, daß ich hin und wieder kleine Ausflüge in Bereiche mache, die nichts mit IT, Administration oder Softwareentwicklung zu tun haben.

Ich wünsche allen Lesern viel Spaß und hin und wieder einen kleinen AHA!-Effekt...

PS: Meine öffentlichen Codeberg-Repositories findet man hier.