ToolTip scrollen

JScrollableToolTip

Dieser Quellcode eines "scrollable tooltip" enthält eine "main" Methode zum Testen und um zu zeigen, wie wir "JScrollableToolTip" benutzen können.

Wir können die Quellkomponente im Konstruktor übergeben (im Beispiel eine JTable). In dem Fall wird die Komponente an das Mausrad gebunden, so dass wir den Tooltip "scrollen" können, sogar wenn die Maus noch über der Quellkomponente ist. Damit lösen wir gleichzeitig das Problem, das entsteht, wenn der Tooltip einer Komponente ausserhalb der Grenzen dieser Komponente erscheint: wenn wir in dem Fall die Maus von der Komponente zum Tooltip hin bewegen, um nach unten "scrollen" zu können, verschwindet der Tooltip!

Im Fall eines "mouseWheelMoved" über der Quellkomponente, wird ein "reset" des "DismissDelay" ausgelöst.

ANMERKUNG für Tooltip in einer JTable: Wenn wir "JScrollableToolTip" für die Zellen einer JTable benutzen möchten, dann müssen wir wissen, dass der "cell renderer" nur indirekt betroffen ist. In erster Linie ist die JTable für den Tooltip verantwortlich. JTable benutzt lediglich den Text vom Renderer. Also müssen wir JTable#createTooltip() überschreiben um eine Instanz von "JScrollableToolTip" zurückzugeben und nicht die Methode "createTooltip" der "renderer component" (sie wird nie aufgerufen).

<code=java>import java.awt.*; import java.awt.event.*; import javax.swing.*; import javax.swing.event.*;

public class JScrollableToolTip extends JToolTip implements MouseWheelListener, AncestorListener {

   private JTextArea tipArea;
   private JScrollPane scrollpane;
   private JComponent comp;

   /** Creates a tool tip. */
   public JScrollableToolTip(final int width, final int height) {
       this(width, height, null);
   }

   public JScrollableToolTip(final int width, final int height, final JComponent comp) {
       this.comp = comp;
       setPreferredSize(new Dimension(width, height));
       setLayout(new BorderLayout());
       tipArea = new JTextArea();
       tipArea.setLineWrap(true);
       tipArea.setWrapStyleWord(true);
       tipArea.setEditable(false);
       tipArea.setBackground(new Color(255, 255, 204));
       scrollpane = new JScrollPane(tipArea);
       add(scrollpane);
       scrollpane.addMouseWheelListener(new MouseWheelListener() {

           @Override
           public void mouseWheelMoved(MouseWheelEvent e) {
               if (comp != null) {
                   MouseEvent e2 = new MouseEvent(comp, MouseEvent.MOUSE_MOVED, 0, 0, 0, 0, 0, false);
                   comp.dispatchEvent(e2);
               }
           }
       });
       addAncestorListener(this);
   }

   @Override
   public void mouseWheelMoved(final MouseWheelEvent e) {
       scrollpane.dispatchEvent(e);
       MouseEvent e2 = new MouseEvent(comp, MouseEvent.MOUSE_MOVED, 0, 0, 0, 0, 0, false);
   }

   @Override
   public void ancestorRemoved(AncestorEvent e) {
       System.out.println("hidden");
       comp.removeMouseWheelListener(this);
   }

   @Override
   public void ancestorAdded(AncestorEvent e) {
       System.out.println("shown");
       comp.addMouseWheelListener(this);
   }

   @Override
   public void ancestorMoved(AncestorEvent e) {
   }

   @Override
   public void setTipText(final String tipText) {
       String oldValue = this.tipArea.getText();
       tipArea.setText(tipText);
       tipArea.setCaretPosition(0);
       firePropertyChange("tiptext", oldValue, tipText);
   }

   @Override
   public String getTipText() {
       return tipArea == null ? "" : tipArea.getText();
   }

   @Override
   protected String paramString() {
       String tipTextString = (tipArea.getText() != null ? tipArea.getText() : "");

       return super.paramString()
               + ",tipText=" + tipTextString;
   }

   //for testing only:
   public static void main(final String args[]) {
       JFrame f = new JFrame();
       f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
       f.setSize(300, 200);
       f.setLocationRelativeTo(null);
       ToolTipManager.sharedInstance().setDismissDelay(10000);
       JTable table = new JTable(50, 4) {

           @Override
           public JToolTip createToolTip() {
               JScrollableToolTip tip = new JScrollableToolTip(200, 80, this);
               tip.setComponent(this);
               return tip;
           }
       };
       table.setToolTipText("Used to display a 'Tip' for a Component. "
               + "Typically components provide api to automate the process of "
               + "using ToolTips. For example, any Swing component can use the "
               + "JComponent  setToolTipText method to specify the text for a standard tooltip.");
       f.add(new JScrollPane(table));
       f.setVisible(true);
   }

} </code=java>