User Tools

Site Tools


api:dk11:activex:tatukgis_xdk11.itgis_viewerwnd.locate_2_itgis_point_double_wordbool

Table of Contents

ITGIS_ViewerWnd.Locate_2 method

DK for ActiveX | TatukGIS_XDK11.ITGIS_ViewerWnd.Locate_2 | Methods | Properties

Locates the shape nearest to _ptg that is within _prec.

Available also on: Delphi FMX | .NET WinForms | Java.

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 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 WordBool If True, only visible shapes are evaluated; shapes hidden by query or visibility settings are ignored.

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. When _visible is True, only visible shapes are evaluated.

2026/07/11 00:16

Page Tools