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.
// Java public TGIS_Shape FindNext();
// Oxygene public function FindNext : TGIS_Shape; virtual;
| Type | Description |
|---|---|
| TGIS_Shape | Next matching shape, or nil when the iterator is exhausted. |
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.