Package uk.ac.starlink.util.gui
Class StringPaster
- java.lang.Object
-
- java.awt.event.MouseAdapter
-
- uk.ac.starlink.util.gui.StringPaster
-
- All Implemented Interfaces:
java.awt.event.MouseListener,java.awt.event.MouseMotionListener,java.awt.event.MouseWheelListener,java.util.EventListener
public abstract class StringPaster extends java.awt.event.MouseAdapterUtility 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 abstractpasted(java.lang.String)method and add it to the component you want to act on usingComponent.addMouseListener(java.awt.event.MouseListener).- Since:
- 3 Dec 2004
- Author:
- Mark Taylor (Starlink), Sun Microsystems
-
-
Constructor Summary
Constructors Constructor Description StringPaster()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected java.awt.ToolkitgetToolkit()Returns the Toolkit holding the selection.protected booleanisPasteEvent(java.awt.event.MouseEvent evt)Determines whether a mouse event counts as a paste.voidmouseClicked(java.awt.event.MouseEvent evt)Invokespasted(java.lang.String)if appropriate.protected abstract voidpasted(java.lang.String str)Invoked when a paste event occurs.
-
-
-
Method Detail
-
mouseClicked
public void mouseClicked(java.awt.event.MouseEvent evt)
Invokespasted(java.lang.String)if appropriate.- Specified by:
mouseClickedin interfacejava.awt.event.MouseListener- Overrides:
mouseClickedin classjava.awt.event.MouseAdapter
-
isPasteEvent
protected boolean isPasteEvent(java.awt.event.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 java.awt.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(java.lang.String str)
Invoked when a paste event occurs.- Parameters:
str- a string that has been pasted from the system-wide selection
-
-