Package uk.ac.starlink.util.gui
Class StringPaster
java.lang.Object
java.awt.event.MouseAdapter
uk.ac.starlink.util.gui.StringPaster
- All Implemented Interfaces:
MouseListener
,MouseMotionListener
,MouseWheelListener
,EventListener
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 Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected Toolkit
Returns the Toolkit holding the selection.protected boolean
isPasteEvent
(MouseEvent evt) Determines whether a mouse event counts as a paste.void
mouseClicked
(MouseEvent evt) Invokespasted(java.lang.String)
if appropriate.protected abstract void
Invoked when a paste event occurs.Methods inherited from class java.awt.event.MouseAdapter
mouseDragged, mouseEntered, mouseExited, mouseMoved, mousePressed, mouseReleased, mouseWheelMoved
-
Constructor Details
-
StringPaster
public StringPaster()
-
-
Method Details
-
mouseClicked
Invokespasted(java.lang.String)
if appropriate.- Specified by:
mouseClicked
in interfaceMouseListener
- Overrides:
mouseClicked
in classMouseAdapter
-
isPasteEvent
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
Returns the Toolkit holding the selection. The default implementation returns AWT's default toolkit.- Returns:
- toolkit for selection
-
pasted
Invoked when a paste event occurs.- Parameters:
str
- a string that has been pasted from the system-wide selection
-