PolygonBuilderEx Class
In This Topic
A builder for creating a polygon whose methods can be called on any thread.
Object Model
Syntax
public sealed class PolygonBuilderEx : MultipartBuilderEx
Public NotInheritable Class PolygonBuilderEx Inherits MultipartBuilderEx
Remarks
Use the PolygonBuilderEx class to to create and/or modify a Polygon shape. The builder is best suited for editing workflows where the user may be adding, inserting or removing parts of a Polygon geometry interactively. A Polygon are based upon the parent Geometry class. The Geometry class is immutable which means that you can not change its shape once it is created. Hence, the PolygonBuilderEx provides the way to make changes when working with a Polygon. Use the PolygonBuilderEx.ToGeometry method to get the Polygon geometry from the builder.
A polygon is defined by a collection of rings. Each ring is a collection of contiguous segments such that the start point and the end point of each Segment are the same (that is, it is a closed ring). If a polygon has more than one ring, the rings may be separate from one another or they may nest inside one another, but they should not overlap. Access the rings of a polygon using the Multipart.Parts method.
Note: For a polygon to be topologically correct, exterior rings should be clockwise and interior rings should be counterclockwise. If there is ever a doubt about the topological correctness of a polygon, call the GeometryEngine.SimplifyAsFeature method to correct any issues.
Most of the PolygonBuilderEx methods can be called on any thread. If a method must be called on the MCT thread, it is noted in the summary.
Inheritance Hierarchy
System.Object
ArcGIS.Core.Geometry.GeometryBuilderEx
ArcGIS.Core.Geometry.MultipartBuilderEx
ArcGIS.Core.Geometry.PolygonBuilderEx
Requirements
Target Platforms: Windows 11, Windows 10, Windows 8.1
See Also