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


IConstructCircularArc.ConstructArcDistance Method (ArcObjects .NET 10.6 SDK)
ArcObjects Library Reference (Geometry)  

IConstructCircularArc.ConstructArcDistance Method

Constructs an arc from a center point, a starting point, and an arc length.

[Visual Basic .NET]
Public Sub ConstructArcDistance ( _
    ByVal Center As IPoint, _
    ByVal from As IPoint, _
    ByVal isCCW As Boolean, _
    ByVal arcDistance As Double _
)
[C#]
public void ConstructArcDistance (
    IPoint Center,
    IPoint from,
    bool isCCW,
    double arcDistance
);
[C++]
HRESULT ConstructArcDistance(
  IPoint* Center,
  IPoint* from,
  VARIANT_BOOL isCCW,
  double arcDistance
);
[C++]

Parameters Center
Center is a parameter of type IPoint* from
from is a parameter of type IPoint* isCCW
isCCW is a parameter of type bool arcDistance
arcDistance is a parameter of type double

Product Availability

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

Description

Constructs a CircularArc given the Center PointFrom Point, the desired orientation, and the desired CircularArc Length.  The Arc Distance must be less than 2 * Pi * the Radius (the distance between the From Point and the Center Point), otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc CircularArc Example

[C#]

        private void ConstructArcDistance()
        {
          IConstructCircularArc constructCircularArc=new CircularArcClass();
          ICircularArc circularArc=constructCircularArc as ICircularArc;
          IPoint fromPoint=new PointClass();
          IPoint toPoint=new PointClass();
          fromPoint.PutCoords(100, 100);
          toPoint.PutCoords(50, 50); 
          constructCircularArc.ConstructArcDistance(fromPoint, toPoint, true, 150); 
          String report="Length : " + circularArc.Length + "\n" +
                          "Radius : " + circularArc.Radius + "\n" +
                          "Chord Height : " + circularArc.ChordHeight + "\n" +
                          "Central Angle (Rad) : " + circularArc.CentralAngle + "\n" +
                          "From Angle (Rad) : " + circularArc.FromAngle + "\n" +
                          "To Angle (Rad) : " + circularArc.ToAngle + "\n" +
                          "Center Point : " + circularArc.CenterPoint.X + " , " + circularArc.CenterPoint.Y + "\n" +
                          "From Point : " + circularArc.FromPoint.X + " , " + circularArc.FromPoint.Y + "\n" +
                          "To Point : " + circularArc.ToPoint.X + " , " + circularArc.ToPoint.Y;
          System.Windows.Forms.MessageBox.Show(report);
        }

[Visual Basic .NET]

    Private Sub ConstructArcDistance()
        Dim pConstructCircularArc As ESRI.ArcGIS.Geometry.IConstructCircularArc
        Dim pCArc As ESRI.ArcGIS.Geometry.ICircularArc
        Dim pCenterPoint As ESRI.ArcGIS.Geometry.IPoint
        Dim pStartPoint As ESRI.ArcGIS.Geometry.IPoint
        pConstructCircularArc=New ESRI.ArcGIS.Geometry.CircularArc
        pCArc=pConstructCircularArc
        pCenterPoint=New ESRI.ArcGIS.Geometry.Point
        pStartPoint=New ESRI.ArcGIS.Geometry.Point
        pCenterPoint.PutCoords(100, 100)
        pStartPoint.PutCoords(50, 50)

        pConstructCircularArc.ConstructArcDistance(pCenterPoint, pStartPoint, True, 150)

        Debug.Print("Length : " & pCArc.Length)
        Debug.Print("Radius : " & pCArc.Radius)
        Debug.Print("Chord Height : " & pCArc.ChordHeight)
        Debug.Print("Central Angle (Rad) : " & pCArc.CentralAngle)
        Debug.Print("From Angle (Rad) : " & pCArc.FromAngle)
        Debug.Print("To Angle (Rad) : " & pCArc.ToAngle)
        Debug.Print("Center Point : " & pCArc.CenterPoint.X & " , " & pCArc.CenterPoint.Y)
        Debug.Print("From Point : " & pCArc.FromPoint.X & " , " & pCArc.FromPoint.Y)
        Debug.Print("To Point : " & pCArc.ToPoint.X & " , " & pCArc.ToPoint.Y)
    End Sub

See Also

IConstructCircularArc Interface | IConstructCircularArc.ConstructTangentDistance Method | IConstructCircularArc.ConstructArcDistance Method | IConstructCircularArc.ConstructChordDistance Method