ESRI.ArcGIS.ADF.IMS
Polygon Class
Members  Example  See Also  Send Feedback
ESRI.ArcGIS.ADF.IMS.Geometry Namespace : Polygon Class




Represents a grouping of Rings.

Object Model

Polygon Class

Syntax

Visual Basic (Declaration) 
<SerializableAttribute()>
Public Class Polygon 
   Inherits Geometry
Visual Basic (Usage)Copy Code
Dim instance As Polygon
C# 
[SerializableAttribute()]
public class Polygon : Geometry

Example

This example creates a polygon on an acetate layer. It adds a single ring to the polygon, and adds a hole inside the ring. The code assumes an existing MapView object.
C#Copy Code
// Create a new polygon
ESRI.ArcGIS.ADF.IMS.Geometry.Polygon poly =
    new ESRI.ArcGIS.ADF.IMS.Geometry.Polygon();
ESRI.ArcGIS.ADF.IMS.Geometry.Ring ring = 
    new ESRI.ArcGIS.ADF.IMS.Geometry.Ring();
poly.Rings.Add(ring);
 
// Create a ring for the polygon
ESRI.ArcGIS.ADF.IMS.Geometry.Point pt;
pt = new ESRI.ArcGIS.ADF.IMS.Geometry.Point(10, 10);
ring.Points.Add(pt);
pt = new ESRI.ArcGIS.ADF.IMS.Geometry.Point(10, 30);
ring.Points.Add(pt);
pt = new ESRI.ArcGIS.ADF.IMS.Geometry.Point(30, 25);
ring.Points.Add(pt);
pt = new ESRI.ArcGIS.ADF.IMS.Geometry.Point(28, 12);
ring.Points.Add(pt);
 
// Add a hole to the ring
ESRI.ArcGIS.ADF.IMS.Geometry.Hole polyHole = 
    new ESRI.ArcGIS.ADF.IMS.Geometry.Hole();
pt = new ESRI.ArcGIS.ADF.IMS.Geometry.Point(12, 12);
polyHole.Points.Add(pt);
pt = new ESRI.ArcGIS.ADF.IMS.Geometry.Point(12, 28);
polyHole.Points.Add(pt);
pt = new ESRI.ArcGIS.ADF.IMS.Geometry.Point(20, 25);
polyHole.Points.Add(pt);
pt = new ESRI.ArcGIS.ADF.IMS.Geometry.Point(22, 13);
polyHole.Points.Add(pt);
ring.Holes.Add(polyHole);
 
// Create an acetate geometry element and add the polygon to it
ESRI.ArcGIS.ADF.IMS.Display.Symbol.SimpleFillSymbol polySymbol =
new ESRI.ArcGIS.ADF.IMS.Display.Symbol.SimpleFillSymbol();
polySymbol.Color = System.Drawing.Color.Red;
ESRI.ArcGIS.ADF.IMS.Display.AcetateElement.GeometryElement acetatePoly =
new ESRI.ArcGIS.ADF.IMS.Display.AcetateElement.GeometryElement(
ESRI.ArcGIS.ADF.IMS.Display.AcetateElement.AcetateUnits.Database, poly, polySymbol);
 
// Create an acetate layer for the geometry element, and add it to the map
ESRI.ArcGIS.ADF.IMS.Carto.Layer.AcetateLayer acetateLayer = 
    new ESRI.ArcGIS.ADF.IMS.Carto.Layer.AcetateLayer("mapGraphics");
acetateLayer.AcetateElements.Add(acetatePoly);
mapView.Layers.Add(acetateLayer);
Visual BasicCopy Code
' Create a new polygon
Dim poly As New ESRI.ArcGIS.ADF.IMS.Geometry.Polygon()
Dim ring As New ESRI.ArcGIS.ADF.IMS.Geometry.Ring()
poly.Rings.Add(ring)
 
' Create a ring for the polygon
Dim pt As ESRI.ArcGIS.ADF.IMS.Geometry.Point pt
pt = New ESRI.ArcGIS.ADF.IMS.Geometry.Point(10, 10)
ring.Points.Add(pt)
pt = New ESRI.ArcGIS.ADF.IMS.Geometry.Point(10, 30)
ring.Points.Add(pt)
pt = New ESRI.ArcGIS.ADF.IMS.Geometry.Point(30, 25)
ring.Points.Add(pt)
pt = New ESRI.ArcGIS.ADF.IMS.Geometry.Point(28, 12)
ring.Points.Add(pt)
 
' Add a hole to the ring
Dim polyHole As New ESRI.ArcGIS.ADF.IMS.Geometry.Hole()
pt = New ESRI.ArcGIS.ADF.IMS.Geometry.Point(12, 12)
polyHole.Points.Add(pt)
pt = New ESRI.ArcGIS.ADF.IMS.Geometry.Point(12, 28)
polyHole.Points.Add(pt)
pt = New ESRI.ArcGIS.ADF.IMS.Geometry.Point(20, 25)
polyHole.Points.Add(pt)
pt = New ESRI.ArcGIS.ADF.IMS.Geometry.Point(22, 13)
polyHole.Points.Add(pt)
ring.Holes.Add(polyHole)
 
' Create an acetate geometry element and add the polygon to it
Dim polySymbol As New _
    ESRI.ArcGIS.ADF.IMS.Display.Symbol.SimpleFillSymbol()
polySymbol.Color = System.Drawing.Color.Red
Dim acetatePoly As New _
    ESRI.ArcGIS.ADF.IMS.Display.AcetateElement.GeometryElement( _
    ESRI.ArcGIS.ADF.IMS.Display.AcetateElement.AcetateUnits.Database, _
    poly, polySymbol)
 
' Create an acetate layer for the geometry element, and add it to the map
Dim acetateLayer As New _
    ESRI.ArcGIS.ADF.IMS.Carto.Layer.AcetateLayer("mapGraphics")
acetateLayer.AcetateElements.Add(acetatePoly)
mapView.Layers.Add(acetateLayer)

Remarks

A Polygon is a type of geometry, and may be used to add graphics to the map, in a filter to select features in a layer, and may be returned as the geometry of features when performing a query. For details, see Geometry.

A Polygon consists of one or more Ring objects. For example, a chain of islands (e.g., Hawaii) may be represented by a single polgyon object with several rings, one ring per island.

A ring in a polygon may have one or more Hole items, which are gaps inside the ring.

The points in the rings and holes of the polygon must occur in the order they will be drawn. A polygon must be closed - the beginning and ending points must be identical. If the last point is not identical to the first, the first point will be duplicated as the last point in the request to the server (though the last point will not be added to the ring's Points collection).

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2011 All Rights Reserved.