- java.lang.Object
-
- java.awt.dnd.DragGestureRecognizer
-
- java.awt.dnd.MouseDragGestureRecognizer
-
- All Implemented Interfaces:
MouseListener
,MouseMotionListener
,Serializable
,EventListener
public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer implements MouseListener, MouseMotionListener
This abstract subclass ofDragGestureRecognizer
defines aDragGestureRecognizer
for mouse-based gestures. Each platform implements its own concrete subclass of this class, available via the Toolkit.createDragGestureRecognizer() method, to encapsulate the recognition of the platform dependent mouse gesture(s) that initiate a Drag and Drop operation.Mouse drag gesture recognizers should honor the drag gesture motion threshold, available through
DragSource.getDragThreshold()
. A drag gesture should be recognized only when the distance in either the horizontal or vertical direction between the ___location of the latest mouse dragged event and the ___location of the corresponding mouse button pressed event is greater than the drag gesture motion threshold.Drag gesture recognizers created with
DragSource.createDefaultDragGestureRecognizer(java.awt.Component, int, java.awt.dnd.DragGestureListener)
follow this convention.- See Also:
DragGestureListener
,DragGestureEvent
,DragSource
, Serialized Form
-
-
Field Summary
-
Fields inherited from class java.awt.dnd.DragGestureRecognizer
component, dragGestureListener, dragSource, events, sourceActions
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
MouseDragGestureRecognizer(DragSource ds)
Construct a newMouseDragGestureRecognizer
given theDragSource
for theComponent
.protected
MouseDragGestureRecognizer(DragSource ds, Component c)
Construct a newMouseDragGestureRecognizer
given theDragSource
for theComponent
c, and theComponent
to observe.protected
MouseDragGestureRecognizer(DragSource ds, Component c, int act)
Construct a newMouseDragGestureRecognizer
given theDragSource
for theComponent
c, theComponent
to observe, and the action(s) permitted for this drag operation.protected
MouseDragGestureRecognizer(DragSource ds, Component c, int act, DragGestureListener dgl)
Construct a newMouseDragGestureRecognizer
given theDragSource
for theComponent
c, theComponent
to observe, the action(s) permitted for this drag operation, and theDragGestureListener
to notify when a drag gesture is detected.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
mouseClicked(MouseEvent e)
Invoked when the mouse has been clicked on a component.void
mouseDragged(MouseEvent e)
Invoked when a mouse button is pressed on a component.void
mouseEntered(MouseEvent e)
Invoked when the mouse enters a component.void
mouseExited(MouseEvent e)
Invoked when the mouse exits a component.void
mouseMoved(MouseEvent e)
Invoked when the mouse button has been moved on a component (with no buttons no down).void
mousePressed(MouseEvent e)
Invoked when a mouse button has been pressed on aComponent
.void
mouseReleased(MouseEvent e)
Invoked when a mouse button has been released on a component.protected void
registerListeners()
register this DragGestureRecognizer's Listeners with the Componentprotected void
unregisterListeners()
unregister this DragGestureRecognizer's Listeners with the Component subclasses must override this method-
Methods inherited from class java.awt.dnd.DragGestureRecognizer
addDragGestureListener, appendEvent, fireDragGestureRecognized, getComponent, getDragSource, getSourceActions, getTriggerEvent, removeDragGestureListener, resetRecognizer, setComponent, setSourceActions
-
-
-
-
Constructor Detail
-
MouseDragGestureRecognizer
protected MouseDragGestureRecognizer(DragSource ds, Component c, int act, DragGestureListener dgl)
Construct a newMouseDragGestureRecognizer
given theDragSource
for theComponent
c, theComponent
to observe, the action(s) permitted for this drag operation, and theDragGestureListener
to notify when a drag gesture is detected.- Parameters:
ds
- The DragSource for the Component cc
- The Component to observeact
- The actions permitted for this Dragdgl
- The DragGestureListener to notify when a gesture is detected
-
MouseDragGestureRecognizer
protected MouseDragGestureRecognizer(DragSource ds, Component c, int act)
Construct a newMouseDragGestureRecognizer
given theDragSource
for theComponent
c, theComponent
to observe, and the action(s) permitted for this drag operation.- Parameters:
ds
- The DragSource for the Component cc
- The Component to observeact
- The actions permitted for this drag
-
MouseDragGestureRecognizer
protected MouseDragGestureRecognizer(DragSource ds, Component c)
Construct a newMouseDragGestureRecognizer
given theDragSource
for theComponent
c, and theComponent
to observe.- Parameters:
ds
- The DragSource for the Component cc
- The Component to observe
-
MouseDragGestureRecognizer
protected MouseDragGestureRecognizer(DragSource ds)
Construct a newMouseDragGestureRecognizer
given theDragSource
for theComponent
.- Parameters:
ds
- The DragSource for the Component
-
-
Method Detail
-
registerListeners
protected void registerListeners()
register this DragGestureRecognizer's Listeners with the Component- Specified by:
registerListeners
in classDragGestureRecognizer
-
unregisterListeners
protected void unregisterListeners()
unregister this DragGestureRecognizer's Listeners with the Component subclasses must override this method- Specified by:
unregisterListeners
in classDragGestureRecognizer
-
mouseClicked
public void mouseClicked(MouseEvent e)
Invoked when the mouse has been clicked on a component.- Specified by:
mouseClicked
in interfaceMouseListener
- Parameters:
e
- theMouseEvent
-
mousePressed
public void mousePressed(MouseEvent e)
Invoked when a mouse button has been pressed on aComponent
.- Specified by:
mousePressed
in interfaceMouseListener
- Parameters:
e
- theMouseEvent
-
mouseReleased
public void mouseReleased(MouseEvent e)
Invoked when a mouse button has been released on a component.- Specified by:
mouseReleased
in interfaceMouseListener
- Parameters:
e
- theMouseEvent
-
mouseEntered
public void mouseEntered(MouseEvent e)
Invoked when the mouse enters a component.- Specified by:
mouseEntered
in interfaceMouseListener
- Parameters:
e
- theMouseEvent
-
mouseExited
public void mouseExited(MouseEvent e)
Invoked when the mouse exits a component.- Specified by:
mouseExited
in interfaceMouseListener
- Parameters:
e
- theMouseEvent
-
mouseDragged
public void mouseDragged(MouseEvent e)
Invoked when a mouse button is pressed on a component.- Specified by:
mouseDragged
in interfaceMouseMotionListener
- Parameters:
e
- theMouseEvent
-
mouseMoved
public void mouseMoved(MouseEvent e)
Invoked when the mouse button has been moved on a component (with no buttons no down).- Specified by:
mouseMoved
in interfaceMouseMotionListener
- Parameters:
e
- theMouseEvent
-
-