Adds a Point to the Polygon by copying the specified Point into the Polygon after any existing points. If called on a multipart Polygon, adds the point to the first ring after any existing points.

Namespace:  ESRI.ArcGISExplorer.Geometry

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

Syntax

C#
public void AddPoint(
	Point pt
)
Visual Basic (Declaration)
Public Sub AddPoint ( _
	pt As Point _
)

Parameters

pt
Type: ESRI.ArcGISExplorer.Geometry..::.Point

A Point to copy in to the Polygon.

Remarks

The AddPoint method is often used as the simplest way to build up the vertices in a new Polygon, by adding a single Point at a time, after any existing points in the Polygon. The [O:ESRI.ArcGISExplorer.Geometry.Polygon.AddPoints] method may be a useful alternative if multiple points can be added at once. Alternatively if the vertices of a Polygon are known before the Polygon object is instantiated, one or more points can be added in the overloaded Polygon constructors.

If the Polygon has multiple rings (RingCount is greater than 1), then the Point is always added to the first ring in the Polygon; if working with multipart polygons, see the AddPoint(Int32, Point) overload in which a ring index can be specified to add the new Point to.

Examples

The code below demonstrates the creation of a simple Polygon using the AddPoint and Close methods. The individual points in the Polygon are also retrieved using the GetPoint method and this information is used to add a Note with popup information to the current map in the application.
CopyC#
// Create a new Polygon, allowing the default CoordinateSystem of WGS84.
Polygon poly = new Polygon();

// Add a series of points to the Polygon (overloads are available to add multiple Points.
poly.AddPoint(new ESRI.ArcGISExplorer.Geometry.Point(2.33434596343321, 48.8628885302916));
poly.AddPoint(new ESRI.ArcGISExplorer.Geometry.Point(2.33269733037166, 48.8603451299656));
poly.AddPoint(new ESRI.ArcGISExplorer.Geometry.Point(2.33659764618658, 48.8594678571346));
poly.AddPoint(new ESRI.ArcGISExplorer.Geometry.Point(2.33960511237599, 48.8591968205275));
poly.AddPoint(new ESRI.ArcGISExplorer.Geometry.Point(2.340578062027, 48.8608773611669));
// Ensure the Polygon is a closed shape.
poly.Close();

// Create a Note using the polygon shape.
Note louvre = new Note("The Louvre", poly, Symbol.Fill.SolidOutline.Green);

// Populate the Note popup information using information about the Polygon.
StringBuilder info = new StringBuilder(@"<p><a href=""http://www.louvre.fr"">The Louvre, Paris</a></p>");
for (int i = 0; i < poly.PointCount(); i++)
{
    ESRI.ArcGISExplorer.Geometry.Point pt = poly.GetPoint(i);
    info.AppendLine(@"<p>" + i.ToString() + ": " + pt.ToString() + @"</p>");
}

MapDisplay disp = ESRI.ArcGISExplorer.Application.Application.ActiveMapDisplay;
louvre.Popup.Content = info.ToString();

// Add the Note to the current Map.
disp.Map.ChildItems.Add(louvre);
CopyVB.NET
' Create a new Polygon, allowing the default CoordinateSystem of WGS84.
Dim poly As Polygon = New Polygon()

' Add a series of points to the Polygon (overloads are available to add multiple Points.
poly.AddPoint(New ESRI.ArcGISExplorer.Geometry.Point(2.33434596343321, 48.8628885302916))
poly.AddPoint(New ESRI.ArcGISExplorer.Geometry.Point(2.33269733037166, 48.8603451299656))
poly.AddPoint(New ESRI.ArcGISExplorer.Geometry.Point(2.33659764618658, 48.8594678571346))
poly.AddPoint(New ESRI.ArcGISExplorer.Geometry.Point(2.33960511237599, 48.8591968205275))
poly.AddPoint(New ESRI.ArcGISExplorer.Geometry.Point(2.340578062027, 48.8608773611669))
' Ensure the Polygon is a closed shape.
poly.Close()

' Create a Note using the polygon shape.
Dim louvre As Note = New Note("The Louvre", poly, Symbol.Fill.SolidOutline.Green)

' Populate the Note popup information using information about the Polygon.
Dim info As StringBuilder = New StringBuilder("<p><a href=""http://www.louvre.fr"">The Louvre, Paris</a></p>")
For i As Integer = 0 To poly.PointCount() - 1
    Dim pt As ESRI.ArcGISExplorer.Geometry.Point = poly.GetPoint(i)
    info.AppendLine("<p>" & i.ToString() & ": " & pt.ToString() & "</p>")
Next

Dim disp As MapDisplay = ESRI.ArcGISExplorer.Application.Application.ActiveMapDisplay
louvre.Popup.Content = info.ToString()

' Add the Note to the current Map.
disp.Map.ChildItems.Add(louvre)

See Also