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

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