org.jhotdraw.draw.tool

Class AbstractTool

java.lang.Object

org.jhotdraw.beans.AbstractBean

org.jhotdraw.draw.tool.AbstractTool

All Implemented Interfaces:

java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.io.Serializable, java.lang.Cloneable, java.util.EventListener, Tool

Direct Known Subclasses:

BezierTool, ConnectionTool, CreationTool, DefaultDragTracker, DefaultHandleTracker, DefaultSelectAreaTracker, DnDTracker, SelectionTool, TextAreaEditingTool, TextEditingTool

public abstract class AbstractTool
extends AbstractBean
implements Tool

This abstract class can be extended to implement a Tool. Design Patterns

Proxy
To remove the need for null-handling, AbstractTool makes use of a proxy for DrawingEditor. Subject: DrawingEditor; Proxy: DrawingEditorProxy; Client: AbstractTool.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AbstractTool() Creates a new instance.

Method Summary

Modifier and Type	Method and Description
void	activate(DrawingEditor editor) Activates the tool for the given editor.
void	addToolListener(ToolListener l) Adds a listener for this tool.
void	addUndoableEditListener(javax.swing.event.UndoableEditListener l)
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.
javax.swing.ActionMap	getActionMap() Gets the action map of the Tool
javax.swing.InputMap	getInputMap() Gets the input map of the Tool
java.lang.String	getToolTipText(DrawingView view, java.awt.event.MouseEvent evt) Returns the tooltip text for a mouse event on a drawing view.
boolean	isActive()
void	keyPressed(java.awt.event.KeyEvent evt) The Tool uses the InputMap to determine what to do, when a key is pressed.
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	setActionMap(javax.swing.ActionMap newValue) Sets the ActionMap for the Tool.
void	setInputMap(javax.swing.InputMap newValue) Sets the InputMap for the Tool.
boolean	supportsHandleInteraction() Returns true, if this tool lets the user interact with handles.
void	updateCursor(DrawingView view, java.awt.Point p)

Methods inherited from class org.jhotdraw.beans.AbstractBean

addPropertyChangeListener, addPropertyChangeListener, clone, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.event.MouseMotionListener

mouseDragged

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 editor. This method is called whenever the user switches to this tool.

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.

Specified by:

deactivate in interface Tool

isActive

public boolean isActive()

setInputMap

public void setInputMap(javax.swing.InputMap newValue)

Sets the InputMap for the Tool.

See Also:

keyPressed(java.awt.event.KeyEvent), setActionMap(javax.swing.ActionMap)

getInputMap

public javax.swing.InputMap getInputMap()

Gets the input map of the Tool

setActionMap

public void setActionMap(javax.swing.ActionMap newValue)

Sets the ActionMap for the Tool.

See Also:

keyPressed(java.awt.event.KeyEvent)

getActionMap

public javax.swing.ActionMap getActionMap()

Gets the action map of the Tool

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)

The Tool uses the InputMap to determine what to do, when a key is pressed. If the corresponding value of the InputMap is a String, the ActionMap of the tool is used, to find the action to be performed. If the corresponding value of the InputMap is a ActionListener, the actionPerformed method of the ActionListener is performed.

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

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)

getToolTipText

public java.lang.String getToolTipText(DrawingView view,
                                       java.awt.event.MouseEvent evt)

Description copied from interface: Tool

Returns the tooltip text for a mouse event on a drawing view.

Specified by:

getToolTipText in interface Tool

Parameters:

view - A drawing view.

evt - A mouse event.

Returns:

A tooltip text or null.

supportsHandleInteraction

public boolean supportsHandleInteraction()

Returns true, if this tool lets the user interact with handles.

Handles may draw differently, if interaction is not possible.

Specified by:

supportsHandleInteraction in interface Tool

Returns:

True, if this tool supports interaction with the handles.