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

[Visual Basic 6.0]
Sub QueryPoint(
    ByVal extension As esriSegmentExtension, _
    ByVal DistanceAlongCurve As Double, _
    ByVal asRatio As Boolean, _
    ByVal outPoint As IPoint _
)

[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
);

[Java]
public void queryPoint (
    esriSegmentExtension extension,
    double DistanceAlongCurve,
    Boolean asRatio,
    IPoint outPoint
)
throws
    IOException,
    AutomationException

[C++]
HRESULT QueryPoint(
  esriSegmentExtension extension,
  double DistanceAlongCurve,
  VARIANT_BOOL asRatio,
  IPoint* outPoint
);

Product Availability

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.

See Also

ICurve Interface | IPoint Interface | esriSegmentExtension Constants

Example

Send feedback on this page