ArcObjects Library Reference (Geometry)  

IPolycurve.SplitAtDistance Method

Introduces a new vertex into this polyline at a specified distance from the beginning of the polyline.

[Visual Basic .NET]
Public Sub SplitAtDistance ( _
    ByVal distance As Double, _
    ByVal asRatio As Boolean, _
    ByVal createPart As Boolean, _
    ByRef SplitHappened As Boolean, _
    ByRef newPartIndex As Integer, _
    ByRef newSegmentIndex As Integer _
)
[C#]
public void SplitAtDistance (
    double distance,
    bool asRatio,
    bool createPart,
    ref bool SplitHappened,
    ref int newPartIndex,
    ref int newSegmentIndex
);
[C++]
HRESULT SplitAtDistance(
  double distance,
  VARIANT_BOOL asRatio,
  VARIANT_BOOL createPart,
  VARIANT_BOOL* SplitHappened,
  long* newPartIndex,
  long* newSegmentIndex
);
[C++]

Parameters

distance   distance is a parameter of type double asRatio   asRatio is a parameter of type VARIANT_BOOL createPart   createPart is a parameter of type VARIANT_BOOL SplitHappened [out]   SplitHappened is a parameter of type VARIANT_BOOL newPartIndex [out]   newPartIndex is a parameter of type long newSegmentIndex [out]   newSegmentIndex is a parameter of type long

Product Availability

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

Description

Adds a new vertex point to the curve at a specified distance from the From point of the curve.  For a split to happen, the split distance must be between the From and To points of the polycurve.

Remarks

CreatePart must be FALSE for polygons.  For polylines, if CreatePart is TRUE, the part on which the new split point falls is split into two parts with the newly added vertex serving as the end of the first part and the beginning of the second.

 

SplitAtDistance Example

See Also

IPolycurve Interface