ArcObjects Library Reference  (Geometry)    

IConstructPath.ConstructRigidStretch Method

Constructs a scaled, rotated version of srcPath. The point at stretchStartIndex will end up at stretchEnd. The points at startAnchor and endAnchor will remain unchanged. Others will be scaled and rotate proportionately.

[Visual Basic 6.0]
Sub ConstructRigidStretch(
    ByVal srcPath As IPath, _
    ByVal stretchStartIndex As Long, _
    ByVal startAnchor As Long, _
    ByVal endAnchor As Long, _
    ByVal stretchEnd As IPoint _
)
[Visual Basic .NET]
Public Sub ConstructRigidStretch ( _
    ByVal srcPath As IPath, _
    ByVal stretchStartIndex As Integer, _
    ByVal startAnchor As Integer, _
    ByVal endAnchor As Integer, _
    ByVal stretchEnd As IPoint _
)
[C#]
public void ConstructRigidStretch (
    IPath srcPath,
    int stretchStartIndex,
    int startAnchor,
    int endAnchor,
    IPoint stretchEnd
);
[Java]
public void constructRigidStretch (
    IPath srcPath,
    int stretchStartIndex,
    int startAnchor,
    int endAnchor,
    IPoint stretchEnd
)
throws
    IOException,
    AutomationException
[C++]
HRESULT ConstructRigidStretch(
  IPath* srcPath,
  long stretchStartIndex,
  long startAnchor,
  long endAnchor,
  IPoint* stretchEnd
);
[C++]

Parameters

srcPath

  srcPath is a parameter of type IPath

stretchStartIndex

  stretchStartIndex is a parameter of type long

startAnchor

  startAnchor is a parameter of type long

endAnchor

  endAnchor is a parameter of type long

stretchEnd

  stretchEnd is a parameter of type IPoint

Product Availability

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

Description

For an existing Path, the ConstructRigidStretch method can be used to rotate and scale the shape of a Path, or just a section of the Path, to a certain point. This method is ideal for use in interactive rubber-sheeting operations. ArcMap, for example, makes use of this method in the ‘Stretch geometry proportionally when moving a vertex’ option.

Remarks

Parameters description:

srcPath: Input IPath object. The path to be stretched. 
stretchStartIndex: Input Long that represents the index of the origin point on the path to be stretched.
startAnchor: Input Long that represents the start anchor. Typically 0 to represent the first point on the path. 
endAnchor: Input Long that represents the end anchor. Typically pointcount-1 to represent the last point on the path. 
stretchEnd: Input IPoint object. The destination point where the strecthStartIndex point will be moved.

 

See Also

IConstructPath Interface

Example

IConstructPath_ConstructRigidStretch_Example

 


Feedback Send feedback on this page