org.jhotdraw.draw.handle

Class AbstractConnectionHandle

java.lang.Object

org.jhotdraw.draw.handle.AbstractHandle

org.jhotdraw.draw.handle.AbstractConnectionHandle

All Implemented Interfaces:

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

Direct Known Subclasses:

ConnectionEndHandle, ConnectionStartHandle

public abstract class AbstractConnectionHandle
extends AbstractHandle

This abstract class can be extended to implement a Handle the start or end point of a ConnectionFigure. XXX - Undo/Redo is not implemented yet.

Method Summary

Modifier and Type	Method and Description
java.util.Collection<Handle>	createSecondaryHandles() Creates secondary handles.
void	draw(java.awt.Graphics2D g) Draws this handle.
ConnectionFigure	getOwner() Returns the owner of this handle.
java.lang.String	getToolTipText(java.awt.Point p) Returns a tooltip for the specified location.
boolean	isCombinableWith(Handle handle) Returns true, if the given handle is an instance of the same class or of a subclass of this handle,.
void	repaintConnectors() Updates the list of connectors that we draw when the user moves or drags the mouse over a figure to which can connect.
void	trackEnd(java.awt.Point anchor, java.awt.Point lead, int modifiersEx) Connects the figure to the new connectableConnector.
void	trackStart(java.awt.Point anchor, int modifiersEx) Disconnects the connection.
void	trackStep(java.awt.Point anchor, java.awt.Point lead, int modifiersEx) Finds a new connectableConnector of the connection.

Methods inherited from class org.jhotdraw.draw.handle.AbstractHandle

addHandleListener, areaInvalidated, attributeChanged, contains, dispose, figureAdded, figureChanged, figureHandlesChanged, figureRemoved, figureRequestRemove, getBounds, getCursor, getDrawingArea, getEditor, getView, invalidate, keyPressed, keyReleased, keyTyped, removeHandleListener, setToolTipText, setView, trackDoubleClick, viewTransformChanged

Methods inherited from class java.lang.Object

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

Method Detail

getOwner

public ConnectionFigure getOwner()

Description copied from interface: Handle

Returns the owner of this handle.

Specified by:

getOwner in interface Handle

Overrides:

getOwner in class AbstractHandle

isCombinableWith

public boolean isCombinableWith(Handle handle)

Description copied from class: AbstractHandle

Returns true, if the given handle is an instance of the same class or of a subclass of this handle,.

Specified by:

isCombinableWith in interface Handle

Overrides:

isCombinableWith in class AbstractHandle

trackStart

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

Disconnects the connection.

Parameters:

anchor - the position where the interaction started

trackStep

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

Finds a new connectableConnector of the connection.

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)

Connects the figure to the new connectableConnector. If there is no new connectableConnector the connection reverts to its original one.

Parameters:

anchor - the position where the interaction started

lead - the current position

draw

public void draw(java.awt.Graphics2D g)

Draws this handle.

Specified by:

draw in interface Handle

Overrides:

draw in class AbstractHandle

createSecondaryHandles

public final java.util.Collection<Handle> createSecondaryHandles()

Description copied from interface: Handle

Creates secondary handles.

Specified by:

createSecondaryHandles in interface Handle

Overrides:

createSecondaryHandles in class AbstractHandle

getToolTipText

@Nullable
public java.lang.String getToolTipText(java.awt.Point p)

Description copied from class: AbstractHandle

Returns a tooltip for the specified location. By default, AbstractHandle returns null.

Specified by:

getToolTipText in interface Handle

Overrides:

getToolTipText in class AbstractHandle

repaintConnectors

public void repaintConnectors()

Updates the list of connectors that we draw when the user moves or drags the mouse over a figure to which can connect.