ICurve3 Interface

Provides access to members that extend the functionality of one dimensional curves.

Members

	Name	Description
	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.
	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.
	IsClosed	Indicates if 'from' and 'to' points (of each part) are identical.
	IsEmpty	Indicates whether this geometry contains any points.
	Length	The length of the curve.
	Project	Projects this geometry into a new spatial reference.
	PutCoordsEx	Sets this segment's endpoints to 'from' and 'to'.
	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.
	QueryPointsAndDistances	Given an input point, calculates the minimum distance to the geometry and provides an enumerator over all closest points on the geometry, along with additional information.
	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.
	ReverseOrientation	Reverses the parameterization of the curve ('from' point becomes 'to' point, first segment becomes last segment, etc).
	SetEmpty	Removes all points from this geometry.
	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.

ICurve3.QueryPointsAndDistances Method

Given an input point, calculates the minimum distance to the geometry and provides an enumerator over all closest points on the geometry, along with additional information.

Public Sub QueryPointsAndDistances ( _
    ByVal extension As esriSegmentExtension, _
    ByVal searchRadius As Double, _
    ByVal inPoint As IPoint, _
    ByVal asRatio As Boolean, _
    ByRef distanceFromCurve As Double, _
    ByRef pointsAndDistances As IEnumPointAndDistance _
)

public void QueryPointsAndDistances (
    esriSegmentExtension extension,
    double searchRadius,
    IPoint inPoint,
    bool asRatio,
    ref double distanceFromCurve,
    ref IEnumPointAndDistance pointsAndDistances
);

Description

This method is similar to QueryPointsAndDistance; but it handles the case where the location of the minimum distance is not unique (See picture below). QueryPointAndDistance returns only the first location, this method returns all locations of minimum distance.

Remarks

AsRatio is an input parameter that only affects the _DistanceAlongCurve_returned as part of the output IEnumPointAndDistance enumerator.

distanceFromCurve is an output parameter that represents the minimum distance between the curve and the input point.

IEnumPointAndDistance is an enumerator (it inherits from IEnumVertex) over all nearest points on the curve

Inherited Interfaces

Interfaces	Description
ICurve2	Provides access to members that extend the functionality of one dimensional curves.
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.

Classes that implement ICurve3

Classes	Description
BezierCurve	A cubic Bezier curve defined between two points; optionally has measure, height and ID attributes at each endpoint.
CircularArc	A portion of a circle that connects two points optionally has measure, height and ID attributes at each endpoint.
EllipticArc	A portion of the boundary of a 2D ellipse that connects two points; optionally has measure, height and ID attributes at each endpoint.
Line	A 2D straight line between a pair of 2D endpoints; can optionally have height, measure and ID attributes at each endpoint.
Polyline	An ordered collection of paths; optionally has measure, height and ID attributes.