com.esri.arcgis.display
Interface IReshapeFeedback

All Superinterfaces:

IDisplayFeedback, Serializable

All Known Implementing Classes:

ReshapeFeedback

public interface IReshapeFeedback
extends IDisplayFeedback, Serializable

Provides access to members that control the reshape display feedback.

Remarks

The ReshapeFeedback allows the user to reshape an object that supports the IPath interface. Such objects are the Path and Ring objects, which can represent one part of a Polyline or Polygon, respectively. The reshaping process can behave in two quite separate ways depending on how the stretch parameter is set.

The Start method takes the input geometry as an IPath, the index of the vertex that is being used, and a Boolean describing how the feedback should behave. The Stop method returns an IPath, which is a new object.

Both Path and Ring objects, which represent single parts of Polyline objects and Polygon objects, respectively, support the IPath interface. Therefore, the object underlying the returned IPath will be either a Ring or a path, depending on the input object's class.

If stretching is set to True, then the whole shape may be scaled or rotated by the feedback and all of the segments may be altered. Conversely, if Stretch is False, then only one vertex and its adjacent segments may be altered. If stretching is used, then the shape is rotated and/or scaled around the start and endpoints of the path. For a Ring, these two points will be coincident and the shape can therefore only undergo a translation--it will maintain its relative shape. For a Path, however, this may not be the case and, as a result, the shape may become transformed or have its actual "shape" changed.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

See Also:

IMoveEnvelopeFeedback, IMoveImageFeedback2, INewBezierCurveFeedback, INewPolygonFeedback, INewMultiPointFeedback, IReshapeFeedback, IMoveImageFeedback, IMoveGeometryFeedback, IResizeEnvelopeFeedback2, INewDimensionFeedback, IResizeEnvelopeFeedback, IPolygonMovePointFeedback, INewLineFeedback, INewCircleFeedback, IVertexFeedback, IMoveLineFeedback, IMovePointFeedback, ILineMovePointFeedback, INewEnvelopeFeedback2, IStretchLineFeedback, INewEnvelopeFeedback, IMovePolygonFeedback

Method Summary

void	start(IPath path, int index, boolean stretch) Begins a feedback operation at the point.
IPath	stop() Finishes a reshape feedback operation.

Methods inherited from interface com.esri.arcgis.display.IDisplayFeedback

getSymbol, moveTo, refresh, setDisplayByRef, setSymbolByRef

Method Detail

start

void start(IPath path,
           int index,
           boolean stretch)
           throws IOException,
                  AutomationException

Begins a feedback operation at the point.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Parameters:

path - A reference to a com.esri.arcgis.geometry.IPath (in)

index - The index (in)

stretch - The stretch (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

stop

IPath stop()
           throws IOException,
                  AutomationException

Finishes a reshape feedback operation.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Returns:

A reference to a com.esri.arcgis.geometry.IPath

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.