org.jhotdraw.draw
Interface Connector

All Superinterfaces:

java.lang.Cloneable, DOMStorable, java.io.Serializable

All Known Implementing Classes:

AbstractConnector, ChopBezierConnector, ChopDiamondConnector, ChopEllipseConnector, ChopRectangleConnector, ChopRoundRectangleConnector, ChopTriangleConnector, LocatorConnector, StickyRectangleConnector

public interface Connector
extends java.lang.Cloneable, java.io.Serializable, DOMStorable

A Connector knows how to locate a connection point on a figure. A Connector knows its owning figure and can determine either the start point or the end point of a given ConnectionFigure. A connector has bounds which describe the area of a figure it is responsible for. A connector can be drawn, but it doesn't have to be.

Version:

2.0 2007-05-19 Connectors don't have the ability to draw themselves anymore. Its the responsibility of the tools and handles to draw the connectors they can connect with.
1.0 2003-12-01 Derived from JHotDraw 5.4b1.

Author:

Werner Randelshofer

Method Summary

java.lang.Object	clone() Returns a clone of the Connection.
boolean	contains(java.awt.geom.Point2D.Double p) Tests if a point is contained in the connector.
void	draw(java.awt.Graphics2D g) Draws the connector.
java.awt.geom.Point2D.Double	findEnd(ConnectionFigure connection) Finds the end point for the connection.
java.awt.geom.Point2D.Double	findStart(ConnectionFigure connection) Finds the start point for the connection.
java.awt.geom.Point2D.Double	getAnchor() Gets the anchor of the connector.
java.awt.geom.Rectangle2D.Double	getBounds() Gets the bounds of the connector.
java.awt.geom.Rectangle2D.Double	getDrawingArea() Gets the drawing area of the connector.
Figure	getOwner() Gets the connector's owner.
void	updateAnchor(java.awt.geom.Point2D.Double p) Updates the anchor of the connector.

Methods inherited from interface org.jhotdraw.xml.DOMStorable

read, write

Method Detail

findStart

java.awt.geom.Point2D.Double findStart(ConnectionFigure connection)

Finds the start point for the connection.

findEnd

java.awt.geom.Point2D.Double findEnd(ConnectionFigure connection)

Finds the end point for the connection.

getOwner

Figure getOwner()

Gets the connector's owner.

getAnchor

java.awt.geom.Point2D.Double getAnchor()

Gets the anchor of the connector. This is a point at the center or at the bounds of the figure, where the start or the end point will most likely be attached. The purpose of this method is to give the user a hint, where the connector will most likely be attached to the owner of the connector.

getBounds

java.awt.geom.Rectangle2D.Double getBounds()

Gets the bounds of the connector. This usually are the bounds of the Figure which owns the Connector. The bounds can differ from the Figure bounds, if the Connector connects to a specific region of the Figure.

updateAnchor

void updateAnchor(java.awt.geom.Point2D.Double p)

Updates the anchor of the connector. This method is called when the user manually changes the end point of the ConnectionFigure. The Connector uses this as a hint for choosing a new anchor position.

contains

boolean contains(java.awt.geom.Point2D.Double p)

Tests if a point is contained in the connector.

clone

java.lang.Object clone()

Returns a clone of the Connection.

getDrawingArea

java.awt.geom.Rectangle2D.Double getDrawingArea()

Gets the drawing area of the connector.

draw

void draw(java.awt.Graphics2D g)

Draws the connector.