com.esri.arcgis.geometry
Interface IConstructLine

All Superinterfaces:

Serializable

All Known Implementing Classes:

Line

public interface IConstructLine
extends Serializable

Provides access to members that construct a line segment using other geometries and measures.

Description

Methods for constructing a Line segment based either on the bisection of an angle defined by three input points or the extension of an existing Line to the boundary of the Spatial Reference.

Product Availability

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

Method Summary

void	constructAngleBisector(IPoint from, IPoint through, IPoint to, double length, boolean useAcuteAngle) Constructs a line segment being the bisector through the angle defined by the three input points.
void	constructExtended(ILine inLine, int extendHow) Extends a line segment until one or both of its endpoints reaches the boundary of the domain of the line's associated spatial reference.

Method Detail

constructAngleBisector

void constructAngleBisector(IPoint from,
                            IPoint through,
                            IPoint to,
                            double length,
                            boolean useAcuteAngle)
                            throws IOException,
                                   AutomationException

Constructs a line segment being the bisector through the angle defined by the three input points.

Description

Constructs a Line segment of given input Length which bisects the Angle formed by the right side of the three input points. The From Point of the new Line is the Through input point. If the right side angle is smaller, the constructed Line will always bisect this angle, regardless of the value of bUseSmallerAngle. However, if the right side angle is larger, and bUseSmallerAngle is TRUE, then the constructed line will bisect the smaller angle (left side) instead of the right side reflex angle.

Remarks

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

from - A reference to a com.esri.arcgis.geometry.IPoint (in)

through - A reference to a com.esri.arcgis.geometry.IPoint (in)

to - A reference to a com.esri.arcgis.geometry.IPoint (in)

length - The length (in)

useAcuteAngle - The useAcuteAngle (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

constructExtended

void constructExtended(ILine inLine,
                       int extendHow)
                       throws IOException,
                              AutomationException

Extends a line segment until one or both of its endpoints reaches the boundary of the domain of the line's associated spatial reference.

Description

Extends a line to the maximum extent of the Spatial Reference given a desired extension method.

Remarks

To extend a Line to another Curve, wrap the Line in a Polyline and use IConstructCurve::ConstructExtended.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

inLine - A reference to a com.esri.arcgis.geometry.ILine (in)

extendHow - A com.esri.arcgis.geometry.esriSegmentExtension constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.