org.jhotdraw.draw
Class SelectionTool

java.lang.Object
  org.jhotdraw.draw.AbstractTool
      org.jhotdraw.draw.SelectionTool

All Implemented Interfaces:

java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.util.EventListener, Tool, ToolListener

Direct Known Subclasses:

DelegationSelectionTool

public class SelectionTool
extends AbstractTool
implements ToolListener

Tool to select and manipulate figures. A selection tool is in one of three states, e.g., background selection, figure selection, handle manipulation. The different states are handled by different tracker objects.

Field Summary

Fields inherited from class org.jhotdraw.draw.AbstractTool

anchor, editor, isWorking, listenerList

Constructor Summary

SelectionTool()
Creates a new instance.

Method Summary

void	activate(DrawingEditor editor) Activates the tool for the given view.
void	areaInvalidated(ToolEvent e) Sent when an area of the drawing view needs to be repainted.
protected Tool	createAreaTracker() Factory method to create an area tracker.
protected Tool	createDragTracker(Figure f) Factory method to create a Drag tracker.
protected Tool	createHandleTracker(Handle handle) Factory method to create a Handle tracker.
void	deactivate(DrawingEditor editor) Deactivates the tool.
void	draw(java.awt.Graphics2D g) Draws the tool.
void	keyPressed(java.awt.event.KeyEvent e)
void	keyReleased(java.awt.event.KeyEvent evt)
void	keyTyped(java.awt.event.KeyEvent evt)
void	mouseClicked(java.awt.event.MouseEvent evt)
void	mouseDragged(java.awt.event.MouseEvent evt)
void	mouseEntered(java.awt.event.MouseEvent evt)
void	mouseExited(java.awt.event.MouseEvent evt)
void	mouseMoved(java.awt.event.MouseEvent evt)
void	mousePressed(java.awt.event.MouseEvent evt)
void	mouseReleased(java.awt.event.MouseEvent evt)
protected void	setTracker(Tool newTracker)
void	toolDone(ToolEvent event) Informs the listener that a tool has done its interaction.
void	toolStarted(ToolEvent event) Informs the listener that a tool has starteds interacting with a specific drawing view.

Methods inherited from class org.jhotdraw.draw.AbstractTool

addToolListener, addUndoableEditListener, constrainPoint, constrainPoint, editCopy, editCut, editDelete, editDuplicate, editPaste, fireAreaInvalidated, fireAreaInvalidated, fireToolDone, fireToolStarted, getDrawing, getEditor, getView, isActive, removeToolListener, removeUndoableEditListener, updateCursor, viewToDrawing

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SelectionTool

public SelectionTool()

Creates a new instance.

Method Detail

activate

public void activate(DrawingEditor editor)

Description copied from interface: Tool

Activates the tool for the given view. This method is called whenever the user switches to this tool. Use this method to reinitialize a tool. Note, a valid view must be present in order for the tool to accept activation

Specified by:

activate in interface Tool

Overrides:

activate in class AbstractTool

deactivate

public void deactivate(DrawingEditor editor)

Description copied from interface: Tool

Deactivates the tool. This method is called whenever the user switches to another tool. Use this method to do some clean-up when the tool is switched. Subclassers should always call super.deactivate.

Specified by:

deactivate in interface Tool

Overrides:

deactivate in class AbstractTool

keyPressed

public void keyPressed(java.awt.event.KeyEvent e)

Specified by:

keyPressed in interface java.awt.event.KeyListener

Overrides:

keyPressed in class AbstractTool

keyReleased

public void keyReleased(java.awt.event.KeyEvent evt)

Specified by:

keyReleased in interface java.awt.event.KeyListener

Overrides:

keyReleased in class AbstractTool

keyTyped

public void keyTyped(java.awt.event.KeyEvent evt)

Specified by:

keyTyped in interface java.awt.event.KeyListener

Overrides:

keyTyped in class AbstractTool

mouseClicked

public void mouseClicked(java.awt.event.MouseEvent evt)

Specified by:

mouseClicked in interface java.awt.event.MouseListener

Overrides:

mouseClicked in class AbstractTool

mouseDragged

public void mouseDragged(java.awt.event.MouseEvent evt)

Specified by:

mouseDragged in interface java.awt.event.MouseMotionListener

mouseEntered

public void mouseEntered(java.awt.event.MouseEvent evt)

Specified by:

mouseEntered in interface java.awt.event.MouseListener

Overrides:

mouseEntered in class AbstractTool

mouseExited

public void mouseExited(java.awt.event.MouseEvent evt)

Specified by:

mouseExited in interface java.awt.event.MouseListener

Overrides:

mouseExited in class AbstractTool

mouseMoved

public void mouseMoved(java.awt.event.MouseEvent evt)

Specified by:

mouseMoved in interface java.awt.event.MouseMotionListener

Overrides:

mouseMoved in class AbstractTool

mouseReleased

public void mouseReleased(java.awt.event.MouseEvent evt)

Specified by:

mouseReleased in interface java.awt.event.MouseListener

Overrides:

mouseReleased in class AbstractTool

draw

public void draw(java.awt.Graphics2D g)

Description copied from interface: Tool

Draws the tool.

Specified by:

draw in interface Tool

Overrides:

draw in class AbstractTool

mousePressed

public void mousePressed(java.awt.event.MouseEvent evt)

Specified by:

mousePressed in interface java.awt.event.MouseListener

Overrides:

mousePressed in class AbstractTool

setTracker

protected void setTracker(Tool newTracker)

createHandleTracker

protected Tool createHandleTracker(Handle handle)

Factory method to create a Handle tracker. It is used to track a handle.

createDragTracker

protected Tool createDragTracker(Figure f)

Factory method to create a Drag tracker. It is used to drag a figure.

createAreaTracker

protected Tool createAreaTracker()

Factory method to create an area tracker. It is used to select an area.

toolStarted

public void toolStarted(ToolEvent event)

Description copied from interface: ToolListener

Informs the listener that a tool has starteds interacting with a specific drawing view.

Specified by:

toolStarted in interface ToolListener

toolDone

public void toolDone(ToolEvent event)

Description copied from interface: ToolListener

Informs the listener that a tool has done its interaction. This method can be used to switch back to the default tool.

Specified by:

toolDone in interface ToolListener

areaInvalidated

public void areaInvalidated(ToolEvent e)

Sent when an area of the drawing view needs to be repainted.

Specified by:

areaInvalidated in interface ToolListener