org.jhotdraw.draw
Class AbstractTool

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

All Implemented Interfaces:

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

Direct Known Subclasses:

BezierTool, BidirectionalConnectionTool, ConnectionTool, CreationTool, DragTracker, HandleTracker, SelectAreaTracker, SelectionTool

public abstract class AbstractTool
extends java.lang.Object
implements Tool

AbstractTool.

Field Summary

protected java.awt.Point	anchor
protected DrawingEditor	editor
protected boolean	isWorking This is set to true, while the tool is doing some work.
protected javax.swing.event.EventListenerList	listenerList

Constructor Summary

AbstractTool()
Creates a new instance.

Method Summary

void	activate(DrawingEditor editor) Activates the tool for the given view.
void	addToolListener(ToolListener l) Adds a listener for this tool.
void	addUndoableEditListener(javax.swing.event.UndoableEditListener l)
protected java.awt.geom.Point2D.Double	constrainPoint(java.awt.Point p)
protected java.awt.geom.Point2D.Double	constrainPoint(java.awt.geom.Point2D.Double p)
void	deactivate(DrawingEditor editor) Deactivates the tool.
void	draw(java.awt.Graphics2D g) Draws the tool.
void	editCopy() Copies the selection into the clipboard.
void	editCut() Cuts the selection into the clipboard.
void	editDelete() Deletes the selection.
void	editDuplicate() Duplicates the selection.
void	editPaste() Pastes the contents of the clipboard.
protected void	fireAreaInvalidated(java.awt.Rectangle invalidatedArea) Notify all listenerList that have registered interest for notification on this event type.
protected void	fireAreaInvalidated(java.awt.geom.Rectangle2D.Double r) Notify all listenerList that have registered interest for notification on this event type.
protected void	fireToolDone() Notify all listenerList that have registered interest for notification on this event type.
protected void	fireToolStarted(DrawingView view) Notify all listenerList that have registered interest for notification on this event type.
protected Drawing	getDrawing()
protected DrawingEditor	getEditor()
protected DrawingView	getView()
boolean	isActive()
void	keyPressed(java.awt.event.KeyEvent evt)
void	keyReleased(java.awt.event.KeyEvent evt)
void	keyTyped(java.awt.event.KeyEvent evt)
void	mouseClicked(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)
void	removeToolListener(ToolListener l) Removes a listener for this tool.
void	removeUndoableEditListener(javax.swing.event.UndoableEditListener l)
void	updateCursor(DrawingView view, java.awt.Point p)
protected java.awt.geom.Point2D.Double	viewToDrawing(java.awt.Point p)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.event.MouseMotionListener

mouseDragged

Field Detail

isWorking

protected boolean isWorking

This is set to true, while the tool is doing some work. This prevents the currentView from being changed when a mouseEnter event is received.

editor

protected DrawingEditor editor

anchor

protected java.awt.Point anchor

listenerList

protected javax.swing.event.EventListenerList listenerList

Constructor Detail

AbstractTool

public AbstractTool()

Creates a new instance.

Method Detail

addUndoableEditListener

public void addUndoableEditListener(javax.swing.event.UndoableEditListener l)

removeUndoableEditListener

public void removeUndoableEditListener(javax.swing.event.UndoableEditListener l)

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

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

isActive

public boolean isActive()

getView

protected DrawingView getView()

getEditor

protected DrawingEditor getEditor()

getDrawing

protected Drawing getDrawing()

viewToDrawing

protected java.awt.geom.Point2D.Double viewToDrawing(java.awt.Point p)

constrainPoint

protected java.awt.geom.Point2D.Double constrainPoint(java.awt.Point p)

constrainPoint

protected java.awt.geom.Point2D.Double constrainPoint(java.awt.geom.Point2D.Double p)

editDelete

public void editDelete()

Deletes the selection. Depending on the tool, this could be selected figures, selected points or selected text.

Specified by:

editDelete in interface Tool

editCut

public void editCut()

Cuts the selection into the clipboard. Depending on the tool, this could be selected figures, selected points or selected text.

Specified by:

editCut in interface Tool

editCopy

public void editCopy()

Copies the selection into the clipboard. Depending on the tool, this could be selected figures, selected points or selected text.

Specified by:

editCopy in interface Tool

editDuplicate

public void editDuplicate()

Duplicates the selection. Depending on the tool, this could be selected figures, selected points or selected text.

Specified by:

editDuplicate in interface Tool

editPaste

public void editPaste()

Pastes the contents of the clipboard. Depending on the tool, this could be selected figures, selected points or selected text.

Specified by:

editPaste in interface Tool

keyReleased

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

Specified by:

keyReleased in interface java.awt.event.KeyListener

keyTyped

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

Specified by:

keyTyped in interface java.awt.event.KeyListener

keyPressed

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

Specified by:

keyPressed in interface java.awt.event.KeyListener

mouseClicked

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

Specified by:

mouseClicked in interface java.awt.event.MouseListener

mouseEntered

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

Specified by:

mouseEntered in interface java.awt.event.MouseListener

mouseExited

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

Specified by:

mouseExited in interface java.awt.event.MouseListener

mouseMoved

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

Specified by:

mouseMoved in interface java.awt.event.MouseMotionListener

mousePressed

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

Specified by:

mousePressed in interface java.awt.event.MouseListener

mouseReleased

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

Specified by:

mouseReleased in interface java.awt.event.MouseListener

addToolListener

public void addToolListener(ToolListener l)

Description copied from interface: Tool

Adds a listener for this tool.

Specified by:

addToolListener in interface Tool

removeToolListener

public void removeToolListener(ToolListener l)

Description copied from interface: Tool

Removes a listener for this tool.

Specified by:

removeToolListener in interface Tool

fireToolStarted

protected void fireToolStarted(DrawingView view)

Notify all listenerList that have registered interest for notification on this event type.

fireToolDone

protected void fireToolDone()

Notify all listenerList that have registered interest for notification on this event type.

fireAreaInvalidated

protected void fireAreaInvalidated(java.awt.geom.Rectangle2D.Double r)

Notify all listenerList that have registered interest for notification on this event type.

fireAreaInvalidated

protected void fireAreaInvalidated(java.awt.Rectangle invalidatedArea)

Notify all listenerList that have registered interest for notification on this event type.

draw

public void draw(java.awt.Graphics2D g)

Description copied from interface: Tool

Draws the tool.

Specified by:

draw in interface Tool

updateCursor

public void updateCursor(DrawingView view,
                         java.awt.Point p)