IEnumVertex.QueryNext Method

Copies the next vertex to the input parameter and returns its location in the geometry.

[Visual Basic .NET]
Public Sub QueryNext ( _
    ByVal vertex As IPoint, _
    ByRef outPartIndex As Integer, _
    ByRef vertexIndex As Integer _
)

[C#]
public void QueryNext (
    IPoint vertex,
    ref int outPartIndex,
    ref int vertexIndex
);

[C++]
HRESULT QueryNext(
  IPoint* vertex,
  long* outPartIndex,
  long* vertexIndex
);

[C++]
Parameters
vertex 
  vertex is a parameter of type IPoint
outPartIndex [out]
  outPartIndex is a parameter of type long
vertexIndex [out]
  vertexIndex is a parameter of type long

Product Availability

Description

The QueryNext method returns the next vertex in the enumerator. As oppose to the Next method the output point needs to be cocreated before to call QueryNext. The QueryNext method is faster than the Next method because it doesn't need to create a point internally each time. The QueryNext method only populates the output point. For example, creating the point only once outside a loop and reuse it in the QueryNext method will be faster than calling Next each time.

Remarks

Note: The output geometry must be co-created prior to use 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