ptolemy.vergil.basic
Class LocatableNodeDragInteractor

java.lang.Object
  extended bydiva.canvas.interactor.AbstractInteractor
      extended bydiva.canvas.interactor.DragInteractor
          extended bydiva.graph.NodeDragInteractor
              extended byptolemy.vergil.basic.LocatableNodeDragInteractor
All Implemented Interfaces:
java.util.EventListener, Interactor, LayerListener, LayerMotionListener

public class LocatableNodeDragInteractor
extends NodeDragInteractor

An interaction role that drags nodes that have locatable objects as semantic objects. When the node is dragged, this interactor updates the location in the locatable object with the new location of the figure.

The dragging of a selection is undoable, and is based on the difference between the point where the mouse was pressed and where the mouse was released. This information is used to create MoML to undo the move if requested.

Since:
Ptolemy II 2.0
Version:
$Id: LocatableNodeDragInteractor.java,v 1.34.2.1 2004/07/19 04:43:54 cxh Exp $
Author:
Steve Neuendorffer
Accepted Rating:
Red (johnr)
Proposed Rating:
Red (eal)

Constructor Summary
LocatableNodeDragInteractor(LocatableNodeController controller)
          Create a new interactor contained within the given controller.
 
Method Summary
 void mousePressed(LayerEvent e)
          When the mouse is pressed before dragging, store a copy of the pressed point location so that a relative move can be evaluated for undo purposes.
 void mouseReleased(LayerEvent e)
          When the mouse is released after dragging, mark the frame modified and update the panner, and generate an undo entry for the move.
 void setSnapResolution(double resolution)
          Specify the snap resolution.
 void translate(LayerEvent e, double x, double y)
          Drag all selected nodes and move any attached edges.
 
Methods inherited from class diva.graph.NodeDragInteractor
getController
 
Methods inherited from class diva.canvas.interactor.DragInteractor
addLayerListener, appendConstraint, constrainPoint, fireLayerEvent, getSelectiveEnabled, getTargetArray, getX, getY, mouseDragged, prependConstraint, removeLayerListener, setSelectiveEnabled, setTargetArray, setup, targets
 
Methods inherited from class diva.canvas.interactor.AbstractInteractor
accept, getMouseFilter, isConsuming, isEnabled, isMotionEnabled, mouseClicked, mouseEntered, mouseExited, mouseMoved, setConsuming, setEnabled, setMotionEnabled, setMouseFilter
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

LocatableNodeDragInteractor

public LocatableNodeDragInteractor(LocatableNodeController controller)
Create a new interactor contained within the given controller.

Method Detail

mousePressed

public void mousePressed(LayerEvent e)
When the mouse is pressed before dragging, store a copy of the pressed point location so that a relative move can be evaluated for undo purposes.

Specified by:
mousePressed in interface LayerListener
Overrides:
mousePressed in class DragInteractor
Parameters:
e - The press event.

mouseReleased

public void mouseReleased(LayerEvent e)
When the mouse is released after dragging, mark the frame modified and update the panner, and generate an undo entry for the move. If no movement has occured, then do nothing.

Specified by:
mouseReleased in interface LayerListener
Overrides:
mouseReleased in class DragInteractor
Parameters:
e - The release event.

setSnapResolution

public void setSnapResolution(double resolution)
Specify the snap resolution. The default snap resolution is 5.0.

Parameters:
resolution - The snap resolution.

translate

public void translate(LayerEvent e,
                      double x,
                      double y)
Drag all selected nodes and move any attached edges. Update the locatable nodes with the current location.

Overrides:
translate in class NodeDragInteractor
Parameters:
e - The event triggering this translation.
x - The horizontal delta.
y - The vertical delta.