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


IEnumCurve2.QueryPoint Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (Geometry)  

IEnumCurve2.QueryPoint Method

Copies a location on this curve into pointOnCurve. AsRatio is true when fromDistance is normalized to the interval [0..1].

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

Parameters fromDistance fromDistance is a parameter of type double asRatio asRatio is a parameter of type VARIANT_BOOL pointOnCurve
pointOnCurve is a parameter of type IPoint

Product Availability

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

Description

The QueryPoint method returns a point object located on the input curve at the fromDistance calculated along the curve. This method can be used to quickly retrieve a large sequence of evenly or unevenly spaced points along a curve. This could be used to place symbols along a curve, for example railroads.

Remarks

Note: Gaps between parts are ignored in distance computations.

Parameters description:

fromDistance: Input Double. Input distance that determines where along the point should be created. The value of that parameter should be in map unit unless asRatio is true.
asRatio: Input Boolean. The asRatio determines if the input distances should be interpreted as map unit asRatio=false distance or parametric distance asRatio=True (0=distance of 0, 1=full length of the curve).

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

IEnumCurve2 Interface