api:dk11:java:tatukgis.jdk.tgis_viewerwnd.locate_tgis_point_double_boolean
Table of Contents
TGIS_ViewerWnd.Locate(TGIS_Point, double, bool) method
DK for Java | tatukgis.jdk.TGIS_ViewerWnd.Locate | Overloads | Constructors | Methods | Properties | Events
Locates the shape nearest to _ptg that is within _prec.
Available also on: Delphi FMX | .NET WinForms | ActiveX.
Syntax
// Java public TGIS_ShapeAbstract Locate( TGIS_Point _ptg, double _prec, bool _visible );
// Oxygene public function Locate( _ptg : TGIS_Point; _prec : Double; _visible : Boolean ) : TGIS_ShapeAbstract;
Parameters
| Name | Type | Description |
|---|---|---|
| _ptg | TGIS_Point | Reference point in map coordinates. |
| _prec | double Double | Maximum search distance in map units; distances for points inside polygons are multiplied by 0.95 and point distances are multiplied by 0.9 to prefer points over lines and polygons. |
| _visible | bool Boolean | If True, only visible shapes are evaluated; shapes hidden by query or visibility settings are ignored. |
Result
| Type | Description |
|---|---|
| TGIS_ShapeAbstract | Located shape or nil. |
Remarks
To improve performance, use section visibility to choose the layer on which to call Locate. When _visible is True, only visible shapes are 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.
2026/07/05 02:36