Interface ISegment
Provides access to members that identify a segment. A segment is a way of getting between two endpoints.
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
[Guid("F2C4F0DE-C5AE-11D0-8307-0000F8034032")]
public interface ISegment : 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
VertexAttributeAware[esriGeometryAttributes]
Indicates if the segment is aware of the specified attribute type.
bool VertexAttributeAware[esriGeometryAttributes attributeType] { get; set; }
Parameters
attributeTypeesriGeometryAttributes
Property Value
Methods
ConvertDistanceMeasureToRatio(double, ref double)
Converts the distance measure to a ratio of the total distance.
void ConvertDistanceMeasureToRatio(double distanceMeasure, ref double distanceRatio)
Parameters
Densify(int, double, out int, out ILine)
Densify segment into the specified number of smaller segments. This method is intended for internal use only.
void Densify(int cInSlots, double maxDeviation, out int pcOutSegments, out ILine segments)
Parameters
Remarks
Densifying individual segments can be accomplished in client code by add the segment to a temporary polyline, then densifying the polyline using one of the methods on IPolycurve. Alternatively, the IGeometryBridge interface on the GeometryEnvironment object can be used.
When using C# you must use the IGeometryBridge interface to call this method.
When using VBNET you must use the IGeometryBridge interface to call this method.
EnvelopeIntersection(IEnvelope, bool, ref double, ref double, ref int, out int)
Finds intersections with clipping envelope; boundaryOverlap is ignored for non-linear segments.
void EnvelopeIntersection(IEnvelope intersectionEnvelope, bool boundaryOverlap, ref double segmentParams, ref double envelopeDistances, ref int numIntersections, out int outcode)
Parameters
intersectionEnvelopeIEnvelopeboundaryOverlapboolsegmentParamsdoubleenvelopeDistancesdoublenumIntersectionsintoutcodeint
GeoNormalize()
void GeoNormalize()
GeoNormalizeFromLongitude(double)
void GeoNormalizeFromLongitude(double Longitude)
Parameters
Longitudedouble
GeographicShift(double)
Shift longitudes to the right of splitLongitude. This method is obsolete.
void GeographicShift(double splitLongitude)
Parameters
splitLongitudedouble
GetDistanceAtVertexAttribute(esriGeometryAttributes, double, bool)
Gets the distance corresponding to the attribute value along the segment.
double GetDistanceAtVertexAttribute(esriGeometryAttributes attributeType, double attributeValue, bool asRatio)
Parameters
attributeTypeesriGeometryAttributesattributeValuedoubleasRatiobool
Returns
GetPointsAtVertexAttribute(esriGeometryAttributes, double, double, out IPointCollection)
Gets the point at the location corresponding to the attribute value.
void GetPointsAtVertexAttribute(esriGeometryAttributes attributeType, double attributeValue, double lateralOffset, out IPointCollection outPoints)
Parameters
attributeTypeesriGeometryAttributesattributeValuedoublelateralOffsetdoubleoutPointsIPointCollection
GetSubSegmentBetweenVertexAttributes(esriGeometryAttributes, double, double, out ISegment)
Gets the segment corresponding to the extent along the segment between the 'from' and 'to' attribute values.
void GetSubSegmentBetweenVertexAttributes(esriGeometryAttributes attributeType, double fromAttribute, double toAttribute, out ISegment outSegment)
Parameters
attributeTypeesriGeometryAttributesfromAttributedoubletoAttributedoubleoutSegmentISegment
GetSubcurve(double, double, bool, out ICurve)
void GetSubcurve(double fromDistance, double toDistance, bool asRatio, out ICurve outSubcurve)
Parameters
GetVertexAttributeAtDistance(esriGeometryAttributes, double, bool)
Gets the attribute value corresponding to the distance along the segment.
double GetVertexAttributeAtDistance(esriGeometryAttributes attributeType, double distance, bool asRatio)
Parameters
attributeTypeesriGeometryAttributesdistancedoubleasRatiobool
Returns
HasVertexAttributes(esriGeometryAttributes, out bool, out bool)
Returns two booleans telling if the segment as from attribute and to attribute values.
void HasVertexAttributes(esriGeometryAttributes attributeType, out bool hasFromAttribute, out bool hasToAttribute)
Parameters
attributeTypeesriGeometryAttributeshasFromAttributeboolhasToAttributebool
HorizontalIntersectionCount(ref WKSPoint, out bool)
Returns the number of horizontal intersections.
int HorizontalIntersectionCount(ref WKSPoint p, out bool pointOnLine)
Parameters
Returns
InterpolateVertexAttributes(double, bool, IPoint)
Interpolates Z and M values at distanceAlongSegment and stores the results at point.
void InterpolateVertexAttributes(double distanceAlongSegment, bool asRatio, IPoint atPoint)
Parameters
MaxDistanceFromLine(ref WKSPoint, ref WKSPoint, double, double, double, ref double, ref double, ref WKSPoint)
Returns the maximum distance from the line.
void MaxDistanceFromLine(ref WKSPoint baseFrom, ref WKSPoint baseTo, double minOffset, double fromArcDistance, double toArcDistance, ref double maxOffset, ref double atArcDistance, ref WKSPoint farPoint)
Parameters
baseFromWKSPointbaseToWKSPointminOffsetdoublefromArcDistancedoubletoArcDistancedoublemaxOffsetdoubleatArcDistancedoublefarPointWKSPoint
Project(ISpatialReference)
void Project(ISpatialReference newReferenceSystem)
Parameters
newReferenceSystemISpatialReference
PutAttributes(bool, bool, ref esriPointAttributes, ref esriPointAttributes)
Sets some attributes from this point and copies them to another point. Awareness is not considered.
void PutAttributes(bool PutAttributes, bool putAwareness, ref esriPointAttributes from, ref esriPointAttributes to)
Parameters
PutVertexAttributes(esriGeometryAttributes, double, double)
Sets the 'from' and the 'to' attribute values.
void PutVertexAttributes(esriGeometryAttributes attributeType, double fromAttribute, double toAttribute)
Parameters
attributeTypeesriGeometryAttributesfromAttributedoubletoAttributedouble
QueryAreaCorrection(out double)
Queries the area correction value.
void QueryAreaCorrection(out double areaCorrection)
Parameters
areaCorrectiondouble
QueryAttributes(bool, bool, ref esriPointAttributes, ref esriPointAttributes)
Gets some attributes from this point and copies them to another point. Awareness is not considered.
void QueryAttributes(bool getAttributes, bool getAwareness, ref esriPointAttributes from, ref esriPointAttributes to)
Parameters
QueryCentroidCorrection(ref double, ref double, ref double)
Queries the centroid correction value.
void QueryCentroidCorrection(ref double weightedCentroidX, ref double weightedCentroidY, ref double areaCorrection)
Parameters
QueryCurvature(double, bool, out double, ILine)
Finds curvature and unit vector starting at point on segment and directed to embedded circle center.
void QueryCurvature(double DistanceAlongCurve, bool asRatio, out double curvature, ILine unitVector)
Parameters
Remarks
The unit vector returned by QueryCurvature points toward the center of the circle that has the same first and second derivative at the queried point with a curvature value equal to 1 / Radius of that circle.

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
QueryVertexAttributes(esriGeometryAttributes, out double, out double)
Gets the 'from' and the 'to' attribute values.
void QueryVertexAttributes(esriGeometryAttributes attributeType, out double fromAttribute, out double toAttribute)
Parameters
attributeTypeesriGeometryAttributesfromAttributedoubletoAttributedouble
QueryWKSEnvelope(ref WKSEnvelope)
Queries the WKS Envelope.
void QueryWKSEnvelope(ref WKSEnvelope Envelope)
Parameters
EnvelopeWKSEnvelope
QueryWKSFromPoint(out WKSPoint)
Query the WKSPoint at the 'from' point.
void QueryWKSFromPoint(out WKSPoint p)
Parameters
pWKSPoint
QueryWKSToPoint(out WKSPoint)
Query the WKSPoint at the 'to' point.
void QueryWKSToPoint(out WKSPoint p)
Parameters
pWKSPoint
ReturnTurnDirection(ISegment)
Finds turn direction between two connected segments.
int ReturnTurnDirection(ISegment otherSegment)
Parameters
otherSegmentISegment
Returns
Remarks
ReturnTurnDirection is only available for Lines and CircularArcs, not BezierCurves or EllipticArcs.

ReverseOrientation()
void ReverseOrientation()
SetEmpty()
void SetEmpty()
SnapToSpatialReference()
void SnapToSpatialReference()
SplitAtDistance(double, bool, out ISegment, out ISegment)
Split segment at specified distance.
void SplitAtDistance(double distances, bool asRatio, out ISegment fromSegment, out ISegment toSegment)
Parameters
Remarks

SplitAtVertexAttribute(esriGeometryAttributes, double, out ISegment, out ISegment)
Splits the segment in two segments at the location corresponding to the attribute value.
void SplitAtVertexAttribute(esriGeometryAttributes attributeType, double attributeValue, out ISegment fromSegment, out ISegment toSegment)
Parameters
attributeTypeesriGeometryAttributesattributeValuedoublefromSegmentISegmenttoSegmentISegment
SplitDivideLength(double, double, bool, ref int, ref ISegment)
Divide segment into smaller segments of the specified length.
void SplitDivideLength(double Offset, double Length, bool asRatio, ref int numSplitSegments, ref ISegment splitSegments)
Parameters
Remarks

When using C# you must use the IGeometryBridge interface to call this method.
When using VBNET you must use the IGeometryBridge interface to call this method.
SynchronizeEmptyAttributes(ISegment)
Synchronize Empty Attributes.
void SynchronizeEmptyAttributes(ISegment toSegment)
Parameters
toSegmentISegment
VertexAttributeOn(esriGeometryAttributes, double)
Indicates if attributeValue is located on this segment.
int VertexAttributeOn(esriGeometryAttributes attributeType, double attributeValue)
Parameters
attributeTypeesriGeometryAttributesattributeValuedouble