ArcObjects Library Reference (Geometry)  

ICurve.QueryPoint Method

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

[Visual Basic .NET]
Public Sub QueryPoint ( _
    ByVal extension As esriSegmentExtension, _
    ByVal DistanceAlongCurve As Double, _
    ByVal asRatio As Boolean, _
    ByVal outPoint As IPoint _
)
[C#]
public void QueryPoint (
    esriSegmentExtension extension,
    double DistanceAlongCurve,
    bool asRatio,
    IPoint outPoint
);
[C++]
HRESULT QueryPoint(
  esriSegmentExtension extension,
  double DistanceAlongCurve,
  VARIANT_BOOL asRatio,
  IPoint* outPoint
);
[C++]

Parameters

extension

  extension is a parameter of type esriSegmentExtension

DistanceAlongCurve   DistanceAlongCurve is a parameter of type double asRatio   asRatio is a parameter of type VARIANT_BOOL outPoint

  outPoint is a parameter of type IPoint

Product Availability

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

Description

Returns the Point at a given distance along the curve or extended curve.  If the distance is less than the length of the curve, then the returned point is the point at that distance along the curve.  If the distance is less than zero, or greater than the length of the curve, then the returned point is on the curve specified by the extension method.  The distance may be specified as a fixed unit of measure or a ratio of the length of the curve.

Remarks

Note: The output geometry must be co-created prior to the query. The output geometry is not co-created by the method; it is populated. This can be used in performance critical situations. For example, creating the geometry only once outside a loop and use the query method could improve performance.

ICurve QueryPoint Example

See Also

ICurve Interface | IPoint Interface | esriSegmentExtension Constants

.NET Samples

Curve conversion add-in (Code Files: CurveConversionDockWin) | ViperPin tool (Code Files: ViperPinForm) |

.NET Related Topics

How to use the ICurve methods | How to work with ICurve methods |