CreateEllipticArcSegment(MapPoint,MapPoint,Coordinate2D,esriArcOrientation,SpatialReference) Method

Convenience method to create a new instance of the EllipticArcSegment class. The new instance will be a circular arc from end points and the center point.

Syntax

C#
Visual Basic (Declaration)

public static EllipticArcSegment CreateEllipticArcSegment( 
   MapPoint startPt,
   MapPoint endPt,
   Coordinate2D centerPt,
   esriArcOrientation orientation,
   SpatialReference spatialReference
)

Public Overloads Shared Function CreateEllipticArcSegment( _
   ByVal startPt As MapPoint, _
   ByVal endPt As MapPoint, _
   ByVal centerPt As Coordinate2D, _
   ByVal orientation As esriArcOrientation, _
   Optional ByVal spatialReference As SpatialReference _
) As EllipticArcSegment

Parameters

startPt: The point from which the arc starts.
endPt: The point to which the arc ends.
centerPt: The center point of the embedded circle.
orientation: The orientation of the arc, clockwise or counterclockwise.
spatialReference: (Optional) The spatial reference. If spatialReference is null, then the spatial reference is inherited from startPt or endPt. The default value is null.

Return Value

An EllipticArcSegment

Exceptions

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

Remarks

The xy-tolerance from the spatial reference is used to create the elliptic arc. If the spatial reference is null, then a default tolerance is used which may cause unexpected results.

Example

// Construct a circular arc from (2, 1) to (1, 2) 
// with center point at (1, 1) and orientation counterclockwise.
// Use a builder convenience method or use a builder constructor.

MapPoint toPt = MapPointBuilder.CreateMapPoint(1, 2);
MapPoint fromPt = MapPointBuilder.CreateMapPoint(2, 1);
Coordinate2D centerPtCoord = new Coordinate2D(1, 1);

// Builder convenience methods don't need to run on the MCT.
EllipticArcSegment circularArc = EllipticArcBuilder.CreateEllipticArcSegment(fromPt, toPt, centerPtCoord, esriArcOrientation.esriArcCounterClockwise);

// Builder constructors need to run on the MCT.
ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() =>
{
  using (EllipticArcBuilder cab = new EllipticArcBuilder(fromPt, toPt, centerPtCoord, esriArcOrientation.esriArcCounterClockwise))
  {
    // do something with the builder

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

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 7

Reference

EllipticArcBuilder Class
EllipticArcBuilder Members
Overload List