org.jhotdraw.draw.tool

Class DelegationSelectionTool

java.lang.Object

org.jhotdraw.beans.AbstractBean

org.jhotdraw.draw.tool.AbstractTool

org.jhotdraw.draw.tool.SelectionTool

org.jhotdraw.draw.tool.DelegationSelectionTool

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

public class DelegationSelectionTool
extends SelectionTool

A SelectionTool, which recognizes double clicks and popup menu triggers. If a double click or popup trigger is encountered a hook method is called, which handles the event. This methods can be overriden in subclasse to provide customized behaviour.

By default, this Tool delegates mouse events to a specific Tool if the figure which has been double clicked, provides a specialized tool.

See Also:

Serialized Form

Field Summary

Fields inherited from class org.jhotdraw.draw.tool.SelectionTool

SELECT_BEHIND_ENABLED_PROPERTY

Fields inherited from class org.jhotdraw.draw.tool.AbstractTool

anchor, editor, isWorking, listenerList

Fields inherited from class org.jhotdraw.beans.AbstractBean

propertySupport

Constructor Summary

Constructors

Constructor and Description
DelegationSelectionTool() Creates a new instance.
DelegationSelectionTool(java.util.Collection<javax.swing.Action> drawingActions, java.util.Collection<javax.swing.Action> selectionActions) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getToolTipText(DrawingView view, java.awt.event.MouseEvent evt) Returns the tooltip text for a mouse event on a drawing view.
protected void	handleDoubleClick(java.awt.event.MouseEvent evt) Hook method which can be overriden by subclasses to provide specialised behaviour in the event of a double click.
protected void	handleMultiClick(java.awt.event.MouseEvent evt) Hook method which can be overriden by subclasses to provide specialised behaviour in the event of a multi-click.
protected void	handlePopupMenu(java.awt.event.MouseEvent evt) Hook method which can be overriden by subclasses to provide specialised behaviour in the event of a popup trigger.
void	mouseClicked(java.awt.event.MouseEvent evt)
void	mouseDragged(java.awt.event.MouseEvent evt)
void	mousePressed(java.awt.event.MouseEvent evt) MouseListener method for mousePressed events.
void	mouseReleased(java.awt.event.MouseEvent evt) MouseListener method for mouseReleased events.
void	setDrawingActions(java.util.Collection<javax.swing.Action> drawingActions)
void	setFigureActions(java.util.Collection<javax.swing.Action> selectionActions)
protected void	showPopupMenu(Figure figure, java.awt.Point p, java.awt.Component c)

Methods inherited from class org.jhotdraw.draw.tool.SelectionTool

activate, deactivate, draw, getDragTracker, getHandleTracker, getSelectAreaTracker, isSelectBehindEnabled, keyPressed, keyReleased, keyTyped, mouseEntered, mouseExited, mouseMoved, setDragTracker, setHandleTracker, setSelectAreaTracker, setSelectBehindEnabled, setTracker, supportsHandleInteraction

Methods inherited from class org.jhotdraw.draw.tool.AbstractTool

addToolListener, addUndoableEditListener, constrainPoint, constrainPoint, createActionMap, createInputMap, editCopy, editCut, editDelete, editDuplicate, editPaste, fireAreaInvalidated, fireAreaInvalidated, fireBoundsInvalidated, fireToolDone, fireToolStarted, getActionMap, getDrawing, getEditor, getInputMap, getView, isActive, maybeFireBoundsInvalidated, removeToolListener, removeUndoableEditListener, setActionMap, setInputMap, updateCursor, viewToDrawing

Methods inherited from class org.jhotdraw.beans.AbstractBean

addPropertyChangeListener, addPropertyChangeListener, clone, firePropertyChange, firePropertyChange, firePropertyChange, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

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

Constructor Detail

DelegationSelectionTool

public DelegationSelectionTool()

Creates a new instance.

DelegationSelectionTool

public DelegationSelectionTool(java.util.Collection<javax.swing.Action> drawingActions,
                               java.util.Collection<javax.swing.Action> selectionActions)

Creates a new instance.

Method Detail

setDrawingActions

public void setDrawingActions(java.util.Collection<javax.swing.Action> drawingActions)

setFigureActions

public void setFigureActions(java.util.Collection<javax.swing.Action> selectionActions)

mousePressed

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

MouseListener method for mousePressed events. If the popup trigger has been activated, then the appropriate hook method is called.

Specified by:

mousePressed in interface java.awt.event.MouseListener

Overrides:

mousePressed in class SelectionTool

mouseReleased

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

MouseListener method for mouseReleased events. If the popup trigger has been activated, then the appropriate hook method is called.

Specified by:

mouseReleased in interface java.awt.event.MouseListener

Overrides:

mouseReleased in class SelectionTool

mouseDragged

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

Specified by:

mouseDragged in interface java.awt.event.MouseMotionListener

Overrides:

mouseDragged in class SelectionTool

mouseClicked

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

Specified by:

mouseClicked in interface java.awt.event.MouseListener

Overrides:

mouseClicked in class SelectionTool

handlePopupMenu

protected void handlePopupMenu(java.awt.event.MouseEvent evt)

Hook method which can be overriden by subclasses to provide specialised behaviour in the event of a popup trigger.

showPopupMenu

protected void showPopupMenu(Figure figure,
                             java.awt.Point p,
                             java.awt.Component c)

handleDoubleClick

protected void handleDoubleClick(java.awt.event.MouseEvent evt)

Hook method which can be overriden by subclasses to provide specialised behaviour in the event of a double click.

handleMultiClick

protected void handleMultiClick(java.awt.event.MouseEvent evt)

Hook method which can be overriden by subclasses to provide specialised behaviour in the event of a multi-click.

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

Overrides:

getToolTipText in class AbstractTool

Parameters:

view - A drawing view.

evt - A mouse event.

Returns:

A tooltip text or null.