Provides access to members that identify a ring and define its behavior.
**Note:** the IRing interface has been superseded by IRing2. Please consider using the more recent version.

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

A Ring is a type of surface patch that defines a two dimensional area and can be used to construct a MultiPatch, defined by a collection of points forming a closed Path, such that the From and To points have the same coordinates. The front side is established by orienting its vertices clockwise.

Description |
||
---|---|---|

Close | Makes sure that this ring is closed by adding a line segment between the ring's 'to' and 'from' points if necessary. | |

Dimension | The topological dimension of this geometry. | |

Envelope | Creates a copy of this geometry's envelope and returns it. | |

FromPoint | The 'from' point of the curve. | |

Generalize | Generalizes this path using the Douglas-Poiker algorithm. | |

GeometryType | The type of this geometry. | |

GeoNormalize | Shifts longitudes, if need be, into a continuous range of 360 degrees. | |

GeoNormalizeFromLongitude | Normalizes longitudes into a continuous range containing the longitude. This method is obsolete. | |

GetSubcurve | Extracts a portion of this curve into a new curve. | |

GetSubcurveEx | Extracts a portion of this curve into a new curve. The interior of the new curve may contain the from/to point of the ring when useRingOrientation is true. | |

IsClosed | Indicates if 'from' and 'to' points (of each part) are identical. | |

IsEmpty | Indicates whether this geometry contains any points. | |

IsExterior | Indicates if this ring can function as the exterior ring in a polygon (ring orientation is clockwise, area > 0). | |

Length | The length of the curve. | |

Project | Projects this geometry into a new spatial reference. | |

QueryChordLengthTangents | Returns tangent vectors (relative to corresponding endpoint) at both sides of a Bezier end point; and whether they have been set by user or by smoothing process. | |

QueryEnvelope | Copies this geometry's envelope properties into the specified envelope. | |

QueryFromPoint | Copies this curve's 'from' point to the input point. | |

QueryNormal | Constructs a line normal to a curve from a point at a specified distance along the curve. | |

QueryPoint | Copies to outPoint the properties of a point on the curve at a specified distance from the beginning of the curve. | |

QueryPointAndDistance | Finds the point on the curve closest to inPoint, then copies that point to outPoint; optionally calculates related items. | |

QueryTangent | Constructs a line tangent to a curve from a point at a specified distance along the curve. | |

QueryToPoint | Copies the curve's 'to' point into the input point. | |

Reshape | Modifies this ring by replacing some of its segments with some segments from reshapeSource. | |

ReverseOrientation | Reverses the parameterization of the curve ('from' point becomes 'to' point, first segment becomes last segment, etc). | |

SetChordLengthTangents | Sets tangent vectors (relative to corresponding endpoint) at both sides of a Bezier end point; if either is Nothing, they will be set by smoothing process. | |

SetEmpty | Removes all points from this geometry. | |

Smooth | Converts this path into a smooth approximation of itself that contains only Bezier curve segments. | |

SmoothLocal | Replaces up to four segments (two on each of the specified vertex index) with bezier curves. | |

SnapToSpatialReference | Moves points of this geometry so that they can be represented in the precision of the geometry's associated spatial reference system. | |

SpatialReference | The spatial reference associated with this geometry. | |

ToPoint | The 'to' point of the curve. |

Interfaces | Description |
---|---|

IPath | Provides access to members that identify a path and define its behavior. |

ICurve | Provides access to properties and methods of all 1 dimensional curves (polylines, segments, boundaries of polygons, etc.). |

IGeometry | Provides access to members that describe properties and behavior of all geometric objects. |

CoClasses and Classes | Description |
---|---|

Ring | An area bounded by one, closed sequence of connected segments; optionally has measure, height and ID attributes at each vertex. |

IPath Interface | IGeometry Interface