api:dk11:activex:tatukgis_xdk11.itgis_layervector.findfirst_2_itgis_extent
Table of Contents
ITGIS_LayerVector.FindFirst_2 method
DK11 for ActiveX | TatukGIS_XDK11.ITGIS_LayerVector.FindFirst_2 | Methods | Properties
Finds the first occurrence of an item which meets an extent. Will use RTree if available.
Syntax
// C# public ITGIS_Shape FindFirst_2( ITGIS_Extent _extent );
' VisualBasic Public Function FindFirst_2( ByVal _extent As ITGIS_Extent ) As ITGIS_Shape
// Oxygene public function FindFirst_2( _extent : ITGIS_Extent ) : ITGIS_Shape;
Parameters
| Name | Type | Description |
|---|---|---|
| _extent | ITGIS_Extent | extent of items to be found; the layer has been attached to the Viewer then expected _extent units are in a Viewer coordinate space; otherwise expected _extent units are in a Layer coordinate space |
Result
| Type | Description |
|---|---|
| ITGIS_Shape | Shape itself or nil. |
Remarks
See: FindNext
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 desired shape.
To locate a shape, simply choose an existing layer and use FindFirst method of with a proper extent and a SQL query as a WHERE clause.
2020/05/07 01:04