api:dk11:activex:tatukgis_xdk11.igis_viewer.locate_2_itgis_point_double_wordbool
Table of Contents
IGIS_Viewer.Locate_2 method
DK for ActiveX | TatukGIS_XDK11.IGIS_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 locate is called upon active paint operations then result could be null. But Locate and paint process are using the same vector enumerator context.
It is recommended to check InPaint property before calling this Locate.
2025/01/31 01:03