Handle (SNAP Engine API)

All Superinterfaces:

Cloneable, Figure, Restorable, ShapeFigure

All Known Implementing Classes:

AbstractHandle, PointHandle, RotateHandle, ScaleHandle, VertexHandle
```
public interface Handle
extends ShapeFigure
```
Handles are shown on figures vertices or boundaries. Usually they when figures are selected. Various handle types may be used to modify a figure's geometry, e.g. resize, rotate or move figures or their vertices.
Important note: The shape and bounds returned by handles are in view coordinates. This is in contrast to figures, which return these properties in model coordinates.
Clients should not implement this interface directly, because it may change in the future. Instead they should derive their Handle implementation from AbstractHandle.

Since:

Ceres 0.10

Nested Class Summary
- Nested classes/interfaces inherited from interface com.bc.ceres.swing.figure.Figure
  Figure.Rank

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`Rectangle2D`	`getBounds()`	The bounds of the handle.
`Cursor`	`getCursor()`
`Point2D`	`getLocation()`
`Shape`	`getShape()`	Gets the shape (geometry) for this figure.
`void`	`setShape(Shape shape)`	Sets the shape (geometry) for this figure.

Methods inherited from interface com.bc.ceres.swing.figure.Figure
addChangeListener, addFigure, addFigure, addFigures, addSegment, clone, contains, createHandles, dispose, draw, getChangeListeners, getEffectiveStyle, getFigure, getFigure, getFigureCount, getFigureIndex, getFigures, getFigures, getMaxSelectionStage, getNormalStyle, getRank, getSegment, getSelectedStyle, isCloseTo, isCollection, isSelectable, isSelected, move, removeAllFigures, removeChangeListener, removeFigure, removeFigures, removeSegment, rotate, scale, setNormalStyle, setSegment, setSelected, setSelectedStyle

Methods inherited from interface com.bc.ceres.swing.undo.Restorable
createMemento, setMemento

- Method Detail
  - getLocation
```
Point2D getLocation()
```
    Returns:
    
    The current location in model coordinates.
  - getCursor
```
Cursor getCursor()
```
    Returns:
    
    The mouse cursor that will appear if users point the mouse over a handle.
  - getShape
```
Shape getShape()
```
    Gets the shape (geometry) for this figure.
    
    Specified by:
    
    getShape in interface ShapeFigure
    
    Returns:
    
    The shape in view coordinates.
  - setShape
```
void setShape(Shape shape)
```
    Sets the shape (geometry) for this figure.
    
    Specified by:
    
    setShape in interface ShapeFigure
    
    Parameters:
    
    shape - The shape in view coordinates.
  - getBounds
```
Rectangle2D getBounds()
```
    The bounds of the handle.
    
    Specified by:
    
    getBounds in interface Figure
    
    Returns:
    
    The bounds of the handle in view units.