Eclipse GEF
3.0

org.eclipse.gef.handles
Class ConnectionHandle

java.lang.Object
  extended byFigure
      extended byorg.eclipse.gef.handles.AbstractHandle
          extended byorg.eclipse.gef.handles.SquareHandle
              extended byorg.eclipse.gef.handles.ConnectionHandle
All Implemented Interfaces:
EventListener, Handle, PropertyChangeListener
Direct Known Subclasses:
BendpointHandle, ConnectionEndHandle, ConnectionStartHandle

public abstract class ConnectionHandle
extends SquareHandle
implements PropertyChangeListener

The base implementation for handles used with editparts whose figure is a Connection. This class adds an additional listener to the owner's connection figure to receive notification whenever the owner's connection's points are changed. Changing the points of a connection does not fire "figure moved", it only fires "points" property as changing.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class org.eclipse.gef.handles.SquareHandle
DEFAULT_HANDLE_SIZE
 
Constructor Summary
ConnectionHandle()
          Creates a new ConnectionHandle.
ConnectionHandle(boolean fixed)
          Creates a new handle with the given fixed setting.
 
Method Summary
 void addNotify()
          Adds this as a FigureListener to the owner's Figure.
 Connection getConnection()
          Convenience method to return the owner's figure typed as Connection.
protected  boolean isFixed()
          Returns true if the handle cannot be dragged.
 void propertyChange(PropertyChangeEvent evt)
           
 void removeNotify()
          Extended to remove a listener.
 void setFixed(boolean fixed)
          Sets whether the handle is fixed and cannot be moved
 
Methods inherited from class org.eclipse.gef.handles.SquareHandle
getBorderColor, getFillColor, init, isPrimary, paintFigure
 
Methods inherited from class org.eclipse.gef.handles.AbstractHandle
ancestorAdded, ancestorMoved, ancestorRemoved, createDragTracker, getAccessibleLocation, getDragCursor, getDragTracker, getLocator, getOwner, getOwnerFigure, setDragCursor, setDragTracker, setLocator, setOwner, validate
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ConnectionHandle

public ConnectionHandle()
Creates a new ConnectionHandle.


ConnectionHandle

public ConnectionHandle(boolean fixed)
Creates a new handle with the given fixed setting. If the handle is fixed, it cannot be dragged.

Parameters:
fixed - true if the handle cannot be dragged.
Method Detail

addNotify

public void addNotify()
Adds this as a FigureListener to the owner's Figure.

Overrides:
addNotify in class AbstractHandle

getConnection

public Connection getConnection()
Convenience method to return the owner's figure typed as Connection.

Returns:
the owner's connection

isFixed

protected boolean isFixed()
Returns true if the handle cannot be dragged.

Returns:
true if the handle cannot be dragged

propertyChange

public void propertyChange(PropertyChangeEvent evt)
Specified by:
propertyChange in interface PropertyChangeListener
See Also:
PropertyChangeListener.propertyChange(java.beans.PropertyChangeEvent)

removeNotify

public void removeNotify()
Extended to remove a listener.

Overrides:
removeNotify in class AbstractHandle
See Also:
IFigure

setFixed

public void setFixed(boolean fixed)
Sets whether the handle is fixed and cannot be moved

Parameters:
fixed - true if the handle should be unmovable

Eclipse GEF
3.0

Copyright (c) IBM Corp. and others 2000, 2004. All Rights Reserved.