diva.canvas.interactor
Class BoundsManipulator

java.lang.Object
  diva.canvas.AbstractFigure
      diva.canvas.AbstractFigureContainer
          diva.canvas.FigureDecorator
              diva.canvas.interactor.Manipulator
                  diva.canvas.interactor.BoundsManipulator

All Implemented Interfaces:

CanvasComponent, Figure, FigureContainer, FigureSet, VisibleComponent, UserObjectContainer

Direct Known Subclasses:

AttributeBoundsManipulator

public class BoundsManipulator
extends Manipulator

A manipulator which attaches grab handles to the bounds of the child figure. It renders the grab handles and gives them a chance to intercept picks.

Version:

$Id: BoundsManipulator.java 38798 2005-07-08 20:00:01Z cxh $

Author:

John Reekie, Michael Shilman

Nested Class Summary

private class

BoundsManipulator.Resizer An interactor class that changes the bounds of the child figure and triggers a repaint.

Field Summary

private Interactor	_dragInteractor The interactor that is attached to a move handle.
private BoundsGeometry	_geometry The geometry "helper"

Constructor Summary

BoundsManipulator()
Construct a new manipulator that uses rectangular grab-handles.

BoundsManipulator(GrabHandleFactory f)
Construct a new manipulator using the given grab-handle factory.

Method Summary

Interactor	getDragInteractor() Return the interactor that is attached to a move handle.
BoundsGeometry	getGeometry() Return the geometry of this manipulator
void	mouseReleased(LayerEvent e) Do nothing.
FigureDecorator	newInstance(Figure f) Create a new instance of this manipulator.
void	refresh() Refresh the geometry.
void	setChild(Figure child) Set the child figure.
void	setDragInteractor(Interactor dragger) Set the drag interactor for figures wrapped by this manipulator.

Methods inherited from class diva.canvas.interactor.Manipulator

addGrabHandle, clearGrabHandles, getBounds, getGrabHandleFactory, getHandleInteractor, isRepainting, paint, pick, relocateGrabHandles, removeGrabHandle, repaint, repaint, repaintAlready, setGrabHandleFactory, setHandleFilter, setHandleInteractor, setRepainting

Methods inherited from class diva.canvas.FigureDecorator

add, contains, figures, figuresFromBack, figuresFromFront, getChild, getContainer, getDecoratedFigure, getFigureCount, getShape, hit, remove, replaceChild, transform, translate

Methods inherited from class diva.canvas.AbstractFigureContainer

decorate, pick, undecorate

Methods inherited from class diva.canvas.AbstractFigure

contains, getInteractor, getLayer, getOrigin, getParent, getToolTipText, getTransformContext, getUserObject, intersects, isVisible, paint, setInteractor, setParent, setToolTipText, setUserObject, setVisible

Methods inherited from class java.lang.Object

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

Methods inherited from interface diva.canvas.VisibleComponent

isVisible, paint, setVisible

Methods inherited from interface diva.canvas.CanvasComponent

getParent, getTransformContext

Field Detail

_geometry

private BoundsGeometry _geometry

The geometry "helper"

_dragInteractor

private Interactor _dragInteractor

The interactor that is attached to a move handle.

Constructor Detail

BoundsManipulator

public BoundsManipulator()

Construct a new manipulator that uses rectangular grab-handles.

BoundsManipulator

public BoundsManipulator(GrabHandleFactory f)

Construct a new manipulator using the given grab-handle factory.

Method Detail

getDragInteractor

public Interactor getDragInteractor()

Return the interactor that is attached to a move handle.

getGeometry

public BoundsGeometry getGeometry()

Return the geometry of this manipulator

mouseReleased

public void mouseReleased(LayerEvent e)

Do nothing. This method is called when the resizer gets a mouse released event, indicating that resizing is complete. Subclasses may wish to override this to, for example, make a persistent record of the new size (which can be obtained by calling getChild().getBounds()).

Parameters:

e - The mouse event.

newInstance

public FigureDecorator newInstance(Figure f)

Create a new instance of this manipulator. The new instance will have the same grab handle, and interactor for grab-handles.

Specified by:

newInstance in class FigureDecorator

refresh

public void refresh()

Refresh the geometry. This adjusts the bounds of the geometry to match the bounds of the child figure.

Specified by:

refresh in class Manipulator

setChild

public void setChild(Figure child)

Set the child figure. If we have any grab-handles, lose them. Then get a rectangle geometry object and create grab-handles on its sites.

Overrides:

setChild in class FigureDecorator

setDragInteractor

public void setDragInteractor(Interactor dragger)

Set the drag interactor for figures wrapped by this manipulator. If set, the manipulator displays an additional handle that can be used to drag the figure. This is useful for certain types of figure that are outlines only.