This document is archived and information here might be outdated.  Recommended version.


IPointCollection Interface (ArcObjects .NET 10.7 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geometry > ESRI.ArcGIS.Geometry > Interfaces > IP > IPointCollection Interface
ArcGIS Developer Help

IPointCollection Interface

Provides access to members that manipulate the points of a Multipoint, Path, Ring, Polyline, Polygon, TriangleFan, TriangleStrip, or MultiPatch. Note: the IPointCollection interface has been superseded by IPointCollection5. Please consider using the more recent version.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Description

Used to access and manipulate the Points in Multipoints, Paths, Rings, Polylines, Polygons, Triangles, TriangleFans, TriangleStrips, and MultiPatches.  IPointCollection can be used to create Multipoints, Triangles, TriangleFans, TriangleStrips, Line-based Paths, Line-based Rings, single-path Line-based Polylines, and single-ring Line-based Polygons.  Multipoints, Triangles, TriangleFans, and TriangleStrips return references to the points in the collection.  All other geometries return copies of points instead of direct references.  PointCollections can be used to get, count, add, insert, query, remove, replace, set, and update the Points in a geometry.  Depending on the method, Points can be manipulated as a single Point, an array of Points, or a collection of Points.

 

If you are using Java or a .NET enabled language, such as VB.NET, you may want to use the alternative versions of IPointCollection methods exposed by the IGeometryBridge and IGeometryBridge2 interfaces.

Members

Name Description
Method AddPoint Adds a vertex to a Path, Ring, Polyline, or Polygon; or adds a reference to the input point to a Multipoint, TriangleFan, or TriangleStrip.
Method AddPointCollection Adds copies of points in the input point collection to this Path, Ring, Polyline, or Polygon; or adds references to the points in the collection to this Multipoint, TriangleFan, or TriangleStrip.
Method AddPoints Adds copies of the input points as vertices to this Path, Ring, Polyline, or Polygon; or references to the input points to this Multipoint, TriangleFan, or TriangleStrip. This method is intended for internal use only.
Method AddWKSPoints Adds vertices to this Path, Ring, Polyline, or Polygon, or adds new points to this Multipoint, TriangleFan, or TriangleStrip.
Read-only property EnumVertices A new enumerator for this point collection.
Method InsertPointCollection Inserts copies of points, from the input point collection, as vertices into this Path, Ring, Polyline, or Polygon; or references to points in the input point collection into this Multipoint, TriangleFan, or TriangleStrip.
Method InsertPoints Inserts copies of the input points as vertices into a Path, Ring, Polyline, or Polygon; or references to the input points into a Multipoint, TriangleFan, or TriangleStrip. This method is intended for internal use only.
Method InsertWKSPoints Inserts new vertices/points into this Path, Ring, Polyline, Polygon, Multipoint, TriangleFan, TriangleStrip, or MultiPatch.
Read-only property Point A copy of the ith vertex of a Path, Ring, Polyline, or Polygon; or a reference to the ith point of a Multipoint, TriangleFan, or TriangleStrip.
Read-only property PointCount The number of points in the collection.
Method QueryPoint Queries for a point in the PointCollection at given index.
Method QueryPoints Copies some points to an existing array of points. This method is intended for internal use only.
Method QueryWKSPoints Copies vertices'/points' coordinates to the array of point structures.
Method RemovePoints Removes vertices from a Path, Ring, Polyline, or Polygon, or references to points from a Multipoint, TriangleFan, or TriangleStrip.
Method ReplacePointCollection Replaces vertices/points within a PointCollection.
Method ReplacePoints Replaces vertices/points within a PointCollection.
Method SetPointCollection Replaces all vertices of this Path, Ring, Polyline, or Polygon with copies of the points in the input collection; or all points of this Multipoint, TriangleFan, or TriangleStrip with references to points from the input collection.
Method SetPoints Replaces all existing vertices of this Path, Ring, Polyline, or Polygon with copies of the input points; or all existing points of this Multipoint, TriangleFan, or TriangleStrip with references to the input points (for C++ and VB users only).
Method SetWKSPoints Replaces all vertices of this Path, Ring, Polyline, or Polygon with new ones, or replaces all points of this Multipoint, TriangleFan, or TriangleStrip with new ones.
Method UpdatePoint Changes the ith vertex or point to be a copy of the input point.

Classes that implement IPointCollection

Classes Description
MultiPatch A collection of surface patches.
Multipoint An ordered collection of points; optionally has measure, height and ID attributes.
Path A sequence of connected segments.
Polygon A collection of rings ordered by their containment relationship; optionally has measure, height and ID attributes.
Polyline An ordered collection of paths; optionally has measure, height and ID attributes.
Ring An area bounded by one, closed sequence of connected segments; optionally has measure, height and ID attributes at each vertex.
TriangleFan A continuous 3D fan of triangles, where each triangle after the first shares an edge with the preceding triangle, and all triangles share a common pivot point.
Triangles A collection of 3D triangles, where each consecutive triplet of vertices defines a new triangle
TriangleStrip A continuous 3D strip of triangles, where each triangle after the first shares an edge with the preceding triangle.

See Also

IPoint Interface | ISegmentCollection Interface | IGeometryCollection Interface | IPointCollection Interface

.NET Samples

Move a graphic along a path in ArcMap Move a graphic along a path in ArcMap Create a custom raster type from the ground up for DMCII data Custom reshape polyline edit task Tabbed feature inspector Custom vertex editing commands Creating a toolbar of globe tools Creating a toolbar of globe tools Draw text on a MapControl 3D multipatch examples 3D multipatch examples 3D multipatch examples 3D multipatch examples 3D multipatch examples 3D multipatch examples 3D multipatch examples 3D multipatch examples 3D multipatch examples 3D multipatch examples Reducing schematic nodes and computing a cumulative attribute via a schematic rule Implementing an XML builder external component StreetMap routing Tabbed feature inspector Triangle graphic element ViperPin tool