This document is archived and information here might be outdated.  Recommended version.


IEnumCurve.GetSubcurve Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (Geometry)  

IEnumCurve.GetSubcurve Method

Extracts a portion of this curve into a new curve.

[Visual Basic .NET]
Public Function GetSubcurve ( _
    ByVal fromDistance As Double, _
    ByVal toDistance As Double, _
    ByVal asRatio As Boolean _
) As ICurve
[C#]
public ICurve GetSubcurve (
    double fromDistance,
    double toDistance,
    bool asRatio
);
[C++]
HRESULT GetSubcurve(
  double fromDistance,
  double toDistance,
  VARIANT_BOOL asRatio,
  ICurve** subcurve
);
[C++]

Parameters fromDistance fromDistance is a parameter of type double toDistance toDistance is a parameter of type double asRatio asRatio is a parameter of type VARIANT_BOOL subcurve [out, retval]
subcurve is a parameter of type ICurve

Product Availability

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

Description

The GetSubCurve method returns a polyline or path object corresponding to a portion of the input curve. If the ISegmentCollection points to a IPolyline or a IPolygon then the output is of type IPolyline, otherwise the output is of type IPath.

Remarks

Note: Gaps between parts are ignored in distance computations.

Parameters description:

fromDistance: Input Double. Input distance that determines where the subcurve should start. The value of that parameter should be in map unit unless asRatio is true.
toDistance: Input Double. Input distance that determines where the subcurve should stop. The value of that parameter should be in map unit unless asRatio is true.
asRatio: Input Boolean. The asRatio determines if the input distances should be interpreted as map unit asRatio=false distance or parametric distance asRatio=True (0=distance of 0, 1=full length of the curve).

See Also

IEnumCurve Interface