api:dk11:activex:tatukgis_xdk11.itgis_viewer.locate_2_itgis_point_double_wordbool
Table of Contents
ITGIS_Viewer.Locate_2 method
DK for ActiveX | TatukGIS_XDK11.ITGIS_Viewer.Locate_2 | Methods | Properties
Locate a shape that is near _ptg, but is closer than _prec distance.
Syntax
// C# public ITGIS_ShapeAbstract Locate_2( ITGIS_Point _ptg, double _prec, WordBool _visible );
' VisualBasic Public Function Locate_2( ByVal _ptg As ITGIS_Point, ByVal _prec As Double, ByVal _visible As WordBool ) As ITGIS_ShapeAbstract
// Oxygene public function Locate_2( _ptg : ITGIS_Point; _prec : Double; _visible : WordBool ) : ITGIS_ShapeAbstract;
Parameters
| Name | Type | Description |
|---|---|---|
| _ptg | ITGIS_Point | reference point /searching point/ |
| _prec | double Double | precision /not a longer distance than/; for points inside the polygon (if _prec >= 0) the distance will be multiply by 0.95 (to prefer points inside the polygon) but will not be bigger then _prec; for point distance will be multiplied by 0.9 to prefer points over lines and polygons; precision is express in map units |
| _visible | WordBool | if true the only visible shapes will be evaluated; shapes turned of by query of hidden will be ignored |
Result
| Type | Description |
|---|---|
| ITGIS_ShapeAbstract | Located shape or nil |
Remarks
To improve performance sections visibility can be used to choose layer to call its Locate method. Only visible shapes will be evaluated.
If no shape is found on a layer, the searcher takes into account labels registered by the allocator (by extent). In order to disable this behavior, _visible must be set to False.
2025/01/31 01:05