api:dk11:net:tatukgis.ndk.winforms.tgis_viewerwnd.locate_tgis_point_double_boolean
Table of Contents
TGIS_ViewerWnd.Locate(TGIS_Point, double, bool) method
DK for .NET | TatukGIS.NDK.WinForms.TGIS_ViewerWnd.Locate | Overloads | Constructors | Fields | Methods | Properties | Events
Locates the shape nearest to _ptg that is within _prec.
Available also on: Delphi FMX | Java | ActiveX.
Syntax
Implements IGIS_Viewer.Locate.
// C# public TGIS_ShapeAbstract Locate( TGIS_Point _ptg, double _prec, bool _visible );
' VisualBasic Public Function Locate( ByVal _ptg As TGIS_Point, ByVal _prec As Double, ByVal _visible As Boolean ) As TGIS_ShapeAbstract
// 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/11 01:19