Inserts a copy of the specified points beginning at the specified point index in the specified ring of the Polygon.

Namespace:  ESRI.ArcGISExplorer.Geometry

Assembly:  ESRI.ArcGISExplorer (in ESRI.ArcGISExplorer.dll) Version: 2.0.0.1500 (2.0.0.1500)

Syntax

C#
public void InsertPoints(
	int ringIndex,
	int pointIndex,
	IEnumerable<Point> points
)
Visual Basic (Declaration)
Public Sub InsertPoints ( _
	ringIndex As Integer, _
	pointIndex As Integer, _
	points As IEnumerable(Of Point) _
)

Parameters

ringIndex
Type: System..::.Int32

The index of the ring to copy the new points into.
pointIndex
Type: System..::.Int32

The point index within the specified ringIndex to copy the new points into.
points
Type: System.Collections.Generic..::.IEnumerable<(Of <(Point>)>)

A generic enumerable set of Point objects to copy into the Polygon.

Remarks

Use this method to insert new points into an existing ring of a multipart Polygon; the inserted points will begin at the specified pointIndex and all following existing points in the ring will increase their index position by the number of points inserted. If the pointIndex is equal to the number of points, this method behaves like the AddPoints method, copying the points after all existing points in the specified ring. The specified ringIndex must already exist in the Polygon.

If working with single part polygons, the InsertPoints(Int32, IEnumerable<(Of <(Point>)>)) overload is also available.

Note that the CoordinateSystem property of any new points added, inserted or set into existing an existing Polygon or Polyline will be discarded, and the coordinates (X and Y properties) of the point assumed to be in the same CoordinateSystem as the Polygon or Polyline to which they are added.

Exceptions

ExceptionCondition
System..::.ArgumentOutOfRangeExceptionThe specified pointIndex must not be greater than the number of existing points in the specified ring, and the specified ringIndex must already exist in the Polygon.

See Also