Interface IPolycurve
Provides access to members that define operations common to polylines and the boundaries of polygons.
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
[Guid("4AFF82E0-F984-11D1-BCA7-0000F875BCCE")]
public interface IPolycurve : ICurve, IGeometry
Properties
Dimension
esriGeometryDimension Dimension { get; }
Property Value
Envelope
IEnvelope Envelope { get; }
Property Value
FromPoint
IPoint FromPoint { get; set; }
Property Value
GeometryType
esriGeometryType GeometryType { get; }
Property Value
IsClosed
bool IsClosed { get; }
Property Value
IsEmpty
bool IsEmpty { get; }
Property Value
Length
double Length { get; }
Property Value
SpatialReference
ISpatialReference SpatialReference { get; set; }
Property Value
ToPoint
IPoint ToPoint { get; set; }
Property Value
Methods
Densify(double, double)
Converts this polycurve into a piecewise linear approximation of itself.
void Densify(double maxSegmentLength, double maxDeviation)
Parameters
Remarks
If the maxSegmentLength is negative IGeometryEnvironment::AutoDensifyTolerance is used. IGeometryEnvironment::AutoDensifyTolerance default value is 0. This value can be explicitly set via IGeometryEnvironment::AutoDensifyTolerance.
If the maxDeviation is negative IGeometryEnvironment::DeviationAutoDensifyTolerance is used. The default value is 2*XYResolution * 100 (2/XYUnits * 100). This value can be explicitly set via IGeometryEnvironment::DeviationAutoDensifyTolerance.
In order to avoid the creation of too many segments, the geometry system uses a maxdeviation = 2*xyResolution * 100 as default value if maxSegmentLength is 0 and the maxDeviation is 0.
If the maxDeviation is positive but smaller than 2*XYResolution of the spatial reference then the maxDeviation used is 2*XYResolution * 100
NOTE: The default values given in this topic are subject to change without notice. If specific values want to be maintained we recommend using the methods on IGeometryEnvironment to set those explicitly.
The start and end points are always honored and remain the same as for the original feature.

Generalize(double)
Generalizes this polycurve using the Douglas-Peucker algorithm.
void Generalize(double maxAllowableOffset)
Parameters
maxAllowableOffsetdouble
Remarks
For polycurve with non-linear segments, the output curve may contain more vertices than the input curve, but all output segments will be linear.

GeoNormalize()
void GeoNormalize()
GeoNormalizeFromLongitude(double)
void GeoNormalizeFromLongitude(double Longitude)
Parameters
Longitudedouble
GetSubcurve(double, double, bool, out ICurve)
void GetSubcurve(double fromDistance, double toDistance, bool asRatio, out ICurve outSubcurve)
Parameters
Project(ISpatialReference)
void Project(ISpatialReference newReferenceSystem)
Parameters
newReferenceSystemISpatialReference
QueryEnvelope(IEnvelope)
void QueryEnvelope(IEnvelope outEnvelope)
Parameters
outEnvelopeIEnvelope
QueryFromPoint(IPoint)
void QueryFromPoint(IPoint from)
Parameters
fromIPoint
QueryNormal(esriSegmentExtension, double, bool, double, ILine)
void QueryNormal(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, double Length, ILine normal)
Parameters
extensionesriSegmentExtensionDistanceAlongCurvedoubleasRatioboolLengthdoublenormalILine
QueryPoint(esriSegmentExtension, double, bool, IPoint)
void QueryPoint(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, IPoint outPoint)
Parameters
extensionesriSegmentExtensionDistanceAlongCurvedoubleasRatiobooloutPointIPoint
QueryPointAndDistance(esriSegmentExtension, IPoint, bool, IPoint, ref double, ref double, ref bool)
void QueryPointAndDistance(esriSegmentExtension extension, IPoint inPoint, bool asRatio, IPoint outPoint, ref double DistanceAlongCurve, ref double distanceFromCurve, ref bool bRightSide)
Parameters
extensionesriSegmentExtensioninPointIPointasRatiobooloutPointIPointDistanceAlongCurvedoubledistanceFromCurvedoublebRightSidebool
QueryTangent(esriSegmentExtension, double, bool, double, ILine)
void QueryTangent(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, double Length, ILine tangent)
Parameters
extensionesriSegmentExtensionDistanceAlongCurvedoubleasRatioboolLengthdoubletangentILine
QueryToPoint(IPoint)
void QueryToPoint(IPoint to)
Parameters
toIPoint
ReverseOrientation()
void ReverseOrientation()
SetEmpty()
void SetEmpty()
Smooth(double)
Converts this curve into a smooth curve containing only Bezier curve segments.
void Smooth(double maxAllowableOffset)
Parameters
maxAllowableOffsetdouble
Remarks

SnapToSpatialReference()
void SnapToSpatialReference()
SplitAtDistance(double, bool, bool, out bool, out int, out int)
Introduces a new vertex into this polyline at a specified distance from the beginning of the polyline.
void SplitAtDistance(double distance, bool asRatio, bool createPart, out bool SplitHappened, out int newPartIndex, out int newSegmentIndex)
Parameters
distancedoubleasRatioboolcreatePartboolSplitHappenedboolnewPartIndexintnewSegmentIndexint
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.

SplitAtPoint(IPoint, bool, bool, out bool, out int, out int)
Introduces a new vertex into this polyline at the location on it closest to the input point.
void SplitAtPoint(IPoint splitPoint, bool projectOnto, bool createPart, out bool SplitHappened, out int newPartIndex, out int newSegmentIndex)
Parameters
splitPointIPointprojectOntoboolcreatePartboolSplitHappenedboolnewPartIndexintnewSegmentIndexint
Remarks
projectOnto is an input parameter that determines if the output point will be located on the polycurve. If projectOnto is true and the input point is not already on the polycurve then the point is projected on the curve.
createPart is an input parameter that determines if parts (paths) have to be created. 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.
SplitHappened is an output parameter that tells if the polycurve has been split or not.
newPartIndex is an output parameter that tells on which part (ring or path) the point has been introduced.
newSegmentIndex is an output parameter that tells what is the index of the new created segment. That index is zero based and part relative (start at 0 for each part).

Weed(double)
Generalizes using a small tolerance based upon either the system units of the geometry's spatial reference, or the geometry's bounding box.
void Weed(double maxAllowableOffsetFactor)
Parameters
maxAllowableOffsetFactordouble
Remarks
For polycurve with non-linear segments, the output curve may contain more vertices than the input curve, but all output segments will be linear.
Weed(X) = Generalize(X * InternalTolerance)
