ArcObjects Library Reference (Geometry)

IGeometryServer2.TrimExtend Method

Trims or extends each polyline in the input array using TrimExtendTo (uses IConstructCurve::ConstructExtended for extension operation).

[Visual Basic .NET]
Public Function TrimExtend ( _
    ByVal pSR As ISpatialReference, _
    ByVal pInPA As IPolylineArray, _
    ByVal pTrimExtendTo As IPolyline, _
    ByVal extendHow As Integer _
) As IPolylineArray

[C#]
public IPolylineArray TrimExtend (
    ISpatialReference pSR,
    IPolylineArray pInPA,
    IPolyline pTrimExtendTo,
    int extendHow
);

[C++]
HRESULT TrimExtend(
  ISpatialReference* pSR,
  IPolylineArray* pInPA,
  IPolyline* pTrimExtendTo,
  long extendHow,
  IPolylineArray** pTE_PA
);

[C++]

Parameters
pSR 

  pSR is a parameter of type ISpatialReference
pInPA 

  pInPA is a parameter of type IPolylineArray
pTrimExtendTo 

  pTrimExtendTo is a parameter of type IPolyline
extendHow 
  extendHow is a parameter of type long
pTE_PA [out, retval]

  pTE_PA is a parameter of type IPolylineArray

Product Availability

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

Remarks

Trims (cuts) polylines that intersect the trim-extend line, or extends polylines to it that don’t intersect it. See the figure below for some examples. The details of how polylines are extended can be controlled by adding together combinations of the values listed in the table below.

values to be used with the trim-extend operation

Constant	Value	Description
esriDefaultCurveExtension	0	By default, extension considers both ends of paths. The old ends remain and new points are added at the extended ends. The new points have attributes that are extrapolated from adjacent existing segments.
esriRelocateEnds	1	If an extension is performed at an end, relocate the end point to the new position instead of leaving the old point and adding a new point at the new position.
esriKeepEndAttributes	2	If an extension is performed at an end, do not extrapolate the end-segment's attributes for the new point. Instead, make its attributes the same as the current end. Incompatible with esriNoAttributes.
esriNoEndAttributes	4	If an extension is performed at an end, do not extrapolate the end-segment's attributes for the new point. Instead, make its attributes be empty. Incompatible with esriKeepAttributes.
esriNoExtendAtFrom	8	Do not extend the 'from' end of any path.
esriNoExtendAtTo	16	Do not extend the 'to' end of any path.

TrimExtend

IGeometryServer2.TrimExtend Method

Product Availability

Remarks

See Also