CreateEllipticArcSegment(MapPoint,Double,Double,Double,esriArcOrientation,MinorOrMajor,SpatialReference) Method

Convenience method to create a new instance of the EllipticArcSegment class. The new instance will be a circular arc.

Syntax

C#
Visual Basic (Declaration)

public static EllipticArcSegment CreateEllipticArcSegment( 
   MapPoint startPt,
   double chordLength,
   double chordBearing,
   double radius,
   esriArcOrientation orientation,
   MinorOrMajor minorOrMajor,
   SpatialReference spatialReference
)

Public Overloads Shared Function CreateEllipticArcSegment( _
   ByVal startPt As MapPoint, _
   ByVal chordLength As Double, _
   ByVal chordBearing As Double, _
   ByVal radius As Double, _
   ByVal orientation As esriArcOrientation, _
   ByVal minorOrMajor As MinorOrMajor, _
   Optional ByVal spatialReference As SpatialReference _
) As EllipticArcSegment

Parameters

startPt: The point from which the arc starts.
chordLength: The length of the chord connecting start point to the end point of the arc.
chordBearing: The angle of the chord connecting start point to the end point of the arc.
radius: The radius of the embedded circle.
orientation: The orientation of the arc, clockwise or counterclockwise.
minorOrMajor: The enumeration value indicating whether the arc is a minor or major arc. A minor arc is an arc such that the central angle is less than PI radians.
spatialReference: (Optional) The spatial reference. If spatialReference is null, then the spatial reference is inherited from startPt. The default value is null.

Return Value

An EllipticArcSegment

Exceptions

Exception	Description
System.InvalidOperationException	Incompatible spatial references.
System.ArgumentNullException	startPt is null.

Example

// Construct a circular arc counterclockwise from (2, 1) to (1, 2) such that the embedded 
// circle has center point at (1, 1) and radius = 1.
// Use a builder convenience method or use a builder constructor.

MapPoint fromPt = MapPointBuilder.CreateMapPoint(2, 1, SpatialReferences.WGS84);
double chordLength = Math.Sqrt(2);
double chordBearing = 3 * Math.PI / 4;
double radius = 1;
esriArcOrientation orientation = esriArcOrientation.esriArcCounterClockwise;
MinorOrMajor minorOrMajor = MinorOrMajor.Minor;

// Builder convenience methods don't need to run on the MCT.
EllipticArcSegment circularArc = EllipticArcBuilder.CreateEllipticArcSegment(fromPt, chordLength, chordBearing, radius, orientation, minorOrMajor);

// Builder constructors need to run on the MCT.
ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() =>
{
  using (EllipticArcBuilder cab = new EllipticArcBuilder(fromPt, chordLength, chordBearing, radius, orientation, minorOrMajor))
  {
    // do something with the builder

    EllipticArcSegment anotherCircularArc = cab.ToSegment();
  }
});

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 7

Reference

EllipticArcBuilder Class
EllipticArcBuilder Members
Overload List