org.jhotdraw.draw
Class ConnectionHandle

java.lang.Object
  org.jhotdraw.draw.AbstractHandle
      org.jhotdraw.draw.LocatorHandle
          org.jhotdraw.draw.ConnectionHandle

All Implemented Interfaces:

java.awt.event.KeyListener, java.util.EventListener, FigureListener, Handle

public class ConnectionHandle
extends LocatorHandle

A handle to connect figures. The connection object to be created is specified by a prototype.

Field Summary

Fields inherited from class org.jhotdraw.draw.AbstractHandle

listenerList, view

Constructor Summary

ConnectionHandle(Figure owner, Locator locator, ConnectionFigure prototype)
Creates a new instance.

Method Summary

protected ConnectionFigure	createConnection() Creates the ConnectionFigure.
void	draw(java.awt.Graphics2D g) Draws this handle.
protected Connector	findConnectionTarget(java.awt.geom.Point2D.Double p, Drawing drawing) Finds a connection end figure.
protected ConnectionFigure	getConnection()
protected Figure	getTargetFigure()
protected void	setConnection(ConnectionFigure newConnection)
protected void	setTargetFigure(Figure newTargetFigure)
void	trackEnd(java.awt.Point anchor, java.awt.Point lead, int modifiersEx) Tracks the end of the interaction.
void	trackStart(java.awt.Point anchor, int modifiersEx) Tracks the start of the interaction.
void	trackStep(java.awt.Point anchor, java.awt.Point lead, int modifiersEx) Tracks a step of the interaction.

Methods inherited from class org.jhotdraw.draw.LocatorHandle

basicGetBounds, getLocation, getLocationOnDrawing

Methods inherited from class org.jhotdraw.draw.AbstractHandle

addHandleListener, contains, createSecondaryHandles, dispose, drawCircle, drawDiamond, drawRectangle, figureAdded, figureAreaInvalidated, figureAttributeChanged, figureChanged, figureRemoved, figureRequestRemove, fireAreaInvalidated, fireHandleRequestRemove, fireHandleRequestSecondaryHandles, fireUndoableEditHappened, getBounds, getCursor, getDrawBounds, getHandlesize, getOwner, invalidate, isCombinableWith, keyPressed, keyReleased, keyTyped, removeHandleListener, setView, trackDoubleClick, updateBounds, viewTransformChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

ConnectionHandle

public ConnectionHandle(Figure owner,
                        Locator locator,
                        ConnectionFigure prototype)

Creates a new instance.

Method Detail

draw

public void draw(java.awt.Graphics2D g)

Description copied from class: AbstractHandle

Draws this handle.

Specified by:

draw in interface Handle

Overrides:

draw in class AbstractHandle

trackStart

public void trackStart(java.awt.Point anchor,
                       int modifiersEx)

Description copied from interface: Handle

Tracks the start of the interaction. The default implementation does nothing.

Parameters:

anchor - the position where the interaction started

trackStep

public void trackStep(java.awt.Point anchor,
                      java.awt.Point lead,
                      int modifiersEx)

Description copied from interface: Handle

Tracks a step of the interaction.

Parameters:

anchor - the position where the interaction started

lead - the current position

trackEnd

public void trackEnd(java.awt.Point anchor,
                     java.awt.Point lead,
                     int modifiersEx)

Description copied from interface: Handle

Tracks the end of the interaction.

Parameters:

anchor - the position where the interaction started

lead - the current position

createConnection

protected ConnectionFigure createConnection()

Creates the ConnectionFigure. By default the figure prototype is cloned.

setConnection

protected void setConnection(ConnectionFigure newConnection)

getConnection

protected ConnectionFigure getConnection()

getTargetFigure

protected Figure getTargetFigure()

setTargetFigure

protected void setTargetFigure(Figure newTargetFigure)

findConnectionTarget

protected Connector findConnectionTarget(java.awt.geom.Point2D.Double p,
                                         Drawing drawing)

Finds a connection end figure.