Find first occurrence of an item which meets extent and query. Will use RTree if available.
// C# public TGIS_Shape FindFirst();
' VisualBasic Public Function FindFirst() As TGIS_Shape
// Oxygene public function FindFirst : TGIS_Shape; virtual;
|TGIS_Shape||Shape itself or nil.|
Use this method to find to the first shape in the layer matching given criteria. Using _query param we can narrow the result of the shape searching down to the minimum. This should speed up our process of locating a desirable shape.
To locate a shape, simply choose an existing layer and use FindFirst method of with a proper extent and SQL query as a WHERE clause.