User Tools

Site Tools


api:dk11:java:tatukgis.jdk.tgis_layervector.findnext_void

Table of Contents

TGIS_LayerVector.FindNext method

DK for Java | tatukgis.jdk.TGIS_LayerVector.FindNext | Constructors | Fields | Methods | Properties | Events

Retrieves the next shape from the active FindFirst query cursor and continues iteration over shapes matching the original criteria.

Available also on: Delphi | .NET | ActiveX | Python.

Syntax

// Java
public TGIS_Shape FindNext();
// Oxygene
public
  function FindNext : TGIS_Shape; virtual;

Result

Type Description
TGIS_Shape Next matching shape, or nil when the iterator is exhausted.

Remarks

PURPOSE: Continue sequential retrieval of shapes started by any FindFirst overload without materializing the full result set.

BEHAVIOR: Uses the internal cursor state created by the preceding FindFirst call and returns the next shape that satisfies the same filters. Returns nil after the last match.

USAGE:

shape = layer.FindFirst(extent)
while shape != nil
  ProcessShape(shape)
  shape = layer.FindNext()

CONSTRAINTS: Requires a prior FindFirst call on the same layer. Cursor state is not reentrant, not thread-safe, and can be invalidated by layer modifications.

See: FindFirst

Use this method to find the next shape in the layer matching given criteria. We can move between shapes by doing custom operations on them.

References

2026/09/20 23:58

Page Tools