Class StringPaster

java.lang.Object
java.awt.event.MouseAdapter
uk.ac.starlink.util.gui.StringPaster
All Implemented Interfaces:
MouseListener, MouseMotionListener, MouseWheelListener, EventListener

public abstract class StringPaster extends MouseAdapter
Utility class to facilitate actions when a string is pasted into a component. If you select some text on a windowing system it's possible to paste it into a JTextComponent which is a convenient way of saving typing. Implementing this for other components is rather fiddly - this class does the hard work for you. To use it, implement the abstract pasted(java.lang.String) method and add it to the component you want to act on using Component.addMouseListener(java.awt.event.MouseListener).
Since:
3 Dec 2004
Author:
Mark Taylor (Starlink), Sun Microsystems
  • Constructor Details

    • StringPaster

      public StringPaster()
  • Method Details

    • mouseClicked

      public void mouseClicked(MouseEvent evt)
      Invokes pasted(java.lang.String) if appropriate.
      Specified by:
      mouseClicked in interface MouseListener
      Overrides:
      mouseClicked in class MouseAdapter
    • isPasteEvent

      protected boolean isPasteEvent(MouseEvent evt)
      Determines whether a mouse event counts as a paste. The default implementation returns true for a single-click using the middle mouse button.
      Parameters:
      evt - mouse event
      Returns:
      true iff evt counts as a paste gesture
    • getToolkit

      protected Toolkit getToolkit()
      Returns the Toolkit holding the selection. The default implementation returns AWT's default toolkit.
      Returns:
      toolkit for selection
    • pasted

      protected abstract void pasted(String str)
      Invoked when a paste event occurs.
      Parameters:
      str - a string that has been pasted from the system-wide selection