CreatePolyline(IEnumerable<MapPoint>,SpatialReference) Method

In This Topic

Convenience method to create a new instance of the Polyline class.

Syntax

Visual Basic (Declaration)
C#

Public Overloads Shared Function CreatePolyline( _
   ByVal points As IEnumerable(Of MapPoint), _
   Optional ByVal spatialReference As SpatialReference _
) As Polyline

public static Polyline CreatePolyline( 
   IEnumerable<MapPoint> points,
   SpatialReference spatialReference
)

Parameters

points: Points to create the polyline. Line segments are created from the coordinates of the points. The spatial references of the points are checked for compatibility.
spatialReference: (Optional) The SpatialReference. The default value is null. If spatialReference is null, then the spatial reference will be inherited from points which requires traversing through the enumeration of points. For improved performance, use CreatePolyline(IEnumerable<MapPoint>,AttributeFlags,SpatialReference).

Return Value

A Polyline.

Exceptions

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

Remarks

The HasZ, HasM and HasID properties are inherited from which requires traversing through the enumeration of points. For improved performance or if you want to set these properties yourself, use CreatePolyline(IEnumerable<MapPoint>,AttributeFlags,SpatialReference).

Example

Builder Properties

{
  // list of points
  List<MapPoint> pointsForBuilder = new List<MapPoint>
{
  MapPointBuilderEx.CreateMapPoint(0, 0, 2, 3, 1),
  MapPointBuilderEx.CreateMapPoint(1, 1, 5, 6),
  MapPointBuilderEx.CreateMapPoint(2, 1, 6),
  MapPointBuilderEx.CreateMapPoint(0, 0)
};

  // will have attributes because it is created with convenience method
  Polyline polylineWithAttrs = PolylineBuilderEx.CreatePolyline(pointsForBuilder);
  bool hasZ = polylineWithAttrs.HasZ;          // hasZ = true
  bool hasM = polylineWithAttrs.HasM;          // hasM = true
  bool hasID = polylineWithAttrs.HasID;        // hasID = true

  // will not have attributes because it is specified as a parameter
  Polyline polylineWithoutAttrs =
    PolylineBuilderEx.CreatePolyline(pointsForBuilder, AttributeFlags.None);
  hasZ = polylineWithoutAttrs.HasZ;          // hasZ = false
  hasM = polylineWithoutAttrs.HasM;          // hasM = false
  hasID = polylineWithoutAttrs.HasID;        // hasID = false

  // will have attributes because it is created with convenience method
  Polygon polygonWithAttrs = PolygonBuilderEx.CreatePolygon(pointsForBuilder);
  hasZ = polygonWithAttrs.HasZ;               // hasZ = true
  hasM = polygonWithAttrs.HasM;               // hasM = true
  hasID = polygonWithAttrs.HasID;             // hasID = true

  // will not have attributes because it is specified as a parameter
  Polygon polygonWithoutAttrs =
        PolygonBuilderEx.CreatePolygon(pointsForBuilder, AttributeFlags.None);
  hasZ = polygonWithoutAttrs.HasZ;               // hasZ = false
  hasM = polygonWithoutAttrs.HasM;               // hasM = false
  hasID = polygonWithoutAttrs.HasID;             // hasID = false

  // will not have attributes because it is specified as a parameter
  PolylineBuilderEx polylineB =
             new PolylineBuilderEx(pointsForBuilder, AttributeFlags.None);
  hasZ = polylineB.HasZ;                      // hasZ = false
  hasM = polylineB.HasM;                      // hasM = false
  hasID = polylineB.HasID;                    // hasID = false

  // will have attributes because it is passed an attributed polyline
  polylineB = new PolylineBuilderEx(polylineWithAttrs);
  hasZ = polylineB.HasZ;                      // hasZ = true
  hasM = polylineB.HasM;                      // hasM = true
  hasID = polylineB.HasID;                    // hasID = true

  // will not have attributes because it is passed a non-attributed polyline
  polylineB = new PolylineBuilderEx(polylineWithoutAttrs);
  hasZ = polylineB.HasZ;                      // hasZ = false
  hasM = polylineB.HasM;                      // hasM = false
  hasID = polylineB.HasID;                    // hasID = false

  // will not have attributes because it is specified as a parameter
  PolygonBuilderEx polygonB = new PolygonBuilderEx(pointsForBuilder, AttributeFlags.None);
  hasZ = polygonB.HasZ;                       // hasZ = false
  hasM = polygonB.HasM;                       // hasM = false
  hasID = polygonB.HasID;                     // hasID = false

  // will have attributes because it is passed an attributed polygon
  polygonB = new PolygonBuilderEx(polygonWithAttrs);
  hasZ = polygonB.HasZ;                       // hasZ = true
  hasM = polygonB.HasM;                       // hasM = true
  hasID = polygonB.HasID;                     // hasID = true

  // will not have attributes because it is passed a non-attributed polygon
  polygonB = new PolygonBuilderEx(polygonWithoutAttrs);
  hasZ = polygonB.HasZ;                       // hasZ = true
  hasM = polygonB.HasM;                       // hasM = true
  hasID = polygonB.HasID;                     // hasID = true
}

Construct a Polyline - from an enumeration of MapPoints

{
  // Use a builderEx convenience method or a builderEx constructor.
  // neither need to run on the MCT

  MapPoint startPt = MapPointBuilderEx.CreateMapPoint(1.0, 1.0);
  MapPoint endPt = MapPointBuilderEx.CreateMapPoint(2.0, 1.0);

  List<MapPoint> list = new List<MapPoint>() { startPt, endPt };

  Polyline polylineFromPointList = PolylineBuilderEx.CreatePolyline(list, SpatialReferences.WGS84);

  // use AttributeFlags.None since we only have 2D points in the list
  PolylineBuilderEx pb = new PolylineBuilderEx(list, AttributeFlags.None);
  pb.SpatialReference = SpatialReferences.WGS84;
  Polyline polyline2 = pb.ToGeometry();

  // Use AttributeFlags.NoAttributes because we only have 2d points in the list
  Polyline polyline4 = PolylineBuilderEx.CreatePolyline(list, AttributeFlags.None);
}

Construct a Polyline - from a Cubic Bezier

{
  polyline = PolylineBuilderEx.CreatePolyline(bezierSegment);
}

Create Bezier Curve Element

{
  //Note: Must be on QueuedTask.Run
  //Build geometry
  Coordinate2D pt1 = new Coordinate2D(1, 7.5);
  Coordinate2D pt2 = new Coordinate2D(1.66, 8);
  Coordinate2D pt3 = new Coordinate2D(2.33, 7.1);
  Coordinate2D pt4 = new Coordinate2D(3, 7.5);
  var bez = new CubicBezierBuilderEx(pt1, pt2, pt3, pt4);
  var bezSeg = bez.ToSegment();
  Polyline bezPl = PolylineBuilderEx.CreatePolyline(bezSeg, AttributeFlags.AllAttributes);

  //Set symbology, create and add element to layout
  CIMLineSymbol lineSym = SymbolFactory.Instance.ConstructLineSymbol(
    ColorFactory.Instance.RedRGB, 4.0, SimpleLineStyle.DashDot);

  ElementFactory.Instance.CreateGraphicElement(layout, bezPl, lineSym, "New Bezier");
}

Create Lasso Line, Freehand Graphic Element

{
  //Note: Must be on QueuedTask.Run
  //Build geometry
  List<Coordinate2D> plCoords = new List<Coordinate2D>();
  plCoords.Add(new Coordinate2D(1.5, 10.5));
  plCoords.Add(new Coordinate2D(1.25, 9.5));
  plCoords.Add(new Coordinate2D(1, 10.5));
  plCoords.Add(new Coordinate2D(0.75, 9.5));
  plCoords.Add(new Coordinate2D(0.5, 10.5));
  plCoords.Add(new Coordinate2D(0.5, 1));
  plCoords.Add(new Coordinate2D(0.75, 2));
  plCoords.Add(new Coordinate2D(1, 1));
  Polyline linePl = PolylineBuilderEx.CreatePolyline(plCoords);

  //Set symbology, create and add element to layout
  CIMLineSymbol lineSym = SymbolFactory.Instance.ConstructLineSymbol(
            ColorFactory.Instance.BlackRGB, 2.0, SimpleLineStyle.Solid);
  //var graphic = GraphicFactory.Instance.CreateShapeGraphic(linePl, lineSym);

  var ge = ElementFactory.Instance.CreateGraphicElement(
                          layout, linePl, lineSym, "New Freehand");
}

Create Line Element

{
  //Note: Must be on QueuedTask.Run

  //Build geometry
  List<Coordinate2D> plCoords = new List<Coordinate2D>();
  plCoords.Add(new Coordinate2D(1, 8.5));
  plCoords.Add(new Coordinate2D(1.66, 9));
  plCoords.Add(new Coordinate2D(2.33, 8.1));
  plCoords.Add(new Coordinate2D(3, 8.5));
  Polyline linePl = PolylineBuilderEx.CreatePolyline(plCoords);

  //Reference a line symbol in a style
  var ProjectStyles = Project.Current.GetItems<StyleProjectItem>();
  StyleProjectItem style = ProjectStyles.First(x => x.Name == "ArcGIS 2D");
  var symStyle = style.SearchSymbols(StyleItemType.LineSymbol, "Line with 2 Markers")[0];
  CIMLineSymbol lineSym = symStyle.Symbol as CIMLineSymbol;
  lineSym.SetSize(20);

  //Set symbology, create and add element to layout
  //CIMLineSymbol lineSym = SymbolFactory.Instance.ConstructLineSymbol(ColorFactory.Instance.BlueRGB, 4.0, SimpleLineStyle.Solid);
  ElementFactory.Instance.CreateGraphicElement(
    layout, linePl, lineSym, "New Line");
}

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

PolylineBuilderEx Class
PolylineBuilderEx Members
Overload List

Send feedback