User Tools

Site Tools


api:dk11:activex:tatukgis_xdk11.igis_viewer.locate_itgis_point_double

Table of Contents

IGIS_Viewer.Locate method

DK for ActiveX | TatukGIS_XDK11.IGIS_Viewer.Locate | Methods | Properties

Locates the shape nearest to _ptg that is within _prec.

Available also on: Delphi | .NET | Java | Python.

Syntax

// C#
public ITGIS_ShapeAbstract Locate(
  ITGIS_Point _ptg,
  double _prec
);
' VisualBasic
Public Function Locate(
  ByVal _ptg As ITGIS_Point,
  ByVal _prec As Double
) As ITGIS_ShapeAbstract
// Oxygene
public
  function Locate(
    _ptg : ITGIS_Point;
    _prec : Double
  ) : ITGIS_ShapeAbstract;

Parameters

Name Type Description
_ptg ITGIS_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.

Result

Type Description
ITGIS_ShapeAbstract Located shape or nil.

Remarks

To improve performance, use section visibility to choose the layer on which to call Locate.

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 00:07

Page Tools