EllipticArcBuilderEx Constructor(MapPoint,Double,Double,Double,ArcOrientation,SpatialReference)

In This Topic

Creates a new instance of the EllipticArcBuilderEx class. The new instance will be a circular arc.

Syntax

Visual Basic (Declaration)
C#

Public Function New( _
   ByVal startPt As MapPoint, _
   ByVal chordLength As Double, _
   ByVal chordBearing As Double, _
   ByVal arcLength As Double, _
   ByVal orientation As ArcOrientation, _
   Optional ByVal spatialReference As SpatialReference _
)

public EllipticArcBuilderEx( 
   MapPoint startPt,
   double chordLength,
   double chordBearing,
   double arcLength,
   ArcOrientation orientation,
   SpatialReference spatialReference
)

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. If negative, then the absolute value is used. Cannot be equal to zero.
chordBearing: The angle in radians of the chord connecting the start point to the end point of the arc.
arcLength: The length of the circular arc. If negative, then the absolute value is used. Cannot be equal to zero.
orientation: The orientation of the arc, clockwise or counterclockwise.
spatialReference: (Optional) The spatial reference of the arc. The default value is null. The spatial reference of the start point is ignored.

Exceptions

Exception	Description
System.ArgumentNullException	startPt is null or empty.
System.ArgumentException	chordLength, chordBearing or arcLength is NaN.
System.ArgumentException	arcLength equals zero.
System.ArgumentException	chordLength is greater than arcLength or chordLength is 0.

Example

Create Ellipse Text Element

{
  //Note: Must be on QueuedTask.Run

  //Build geometry
  Coordinate2D center = new Coordinate2D(4.5, 2.75);
  var eabElp = new EllipticArcBuilderEx(center, 0, 1, 0.45, ArcOrientation.ArcClockwise);
  var ellipse = eabElp.ToSegment();

  var poly = PolygonBuilderEx.CreatePolygon(
    PolylineBuilderEx.CreatePolyline(ellipse, AttributeFlags.AllAttributes));

  //Set symbology, create and add element to layout
  CIMTextSymbol sym = SymbolFactory.Instance.ConstructTextSymbol(
                        ColorFactory.Instance.BlueRGB, 10, "Arial", "Regular");
  string text = "Ellipse, ellipse, ellipse";

  GraphicElement ge = ElementFactory.Instance.CreateTextGraphicElement(
    layout, TextType.PolygonParagraph, poly, sym, text, "New Ellipse Text", false);
}

Create Predefined Shape Graphic Element 3

{
  //Note: Must be on QueuedTask.Run

  //Build geometry
  Coordinate2D center = new Coordinate2D(2, 2.75);
  var eabElp = new EllipticArcBuilderEx(
                           center, 0, 1, 0.45, ArcOrientation.ArcClockwise);
  var ellipse = eabElp.ToSegment();

  //Set symbology, create and add element to layout
  CIMStroke outline = SymbolFactory.Instance.ConstructStroke(
                        ColorFactory.Instance.GreenRGB, 2.0, SimpleLineStyle.Dot);
  CIMPolygonSymbol ellipseSym = SymbolFactory.Instance.ConstructPolygonSymbol(
                   ColorFactory.Instance.GreyRGB, SimpleFillStyle.Vertical, outline);

  var poly = PolygonBuilderEx.CreatePolygon(
    PolylineBuilderEx.CreatePolyline(ellipse, AttributeFlags.AllAttributes));

  var ge = ElementFactory.Instance.CreatePredefinedShapeGraphicElement(
    layout, PredefinedShape.Ellipse, poly.Extent.Center, 0, 0, ellipseSym,
    "New Ellipse2", false, new ElementInfo() { Anchor = Anchor.TopRightCorner });
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

EllipticArcBuilderEx Class
EllipticArcBuilderEx Members
Overload List

Send feedback