User Tools

Site Tools


api:dk11:activex:tatukgis_xdk11.igis_viewer.locate_3_itpoint_integer

Table of Contents

IGIS_Viewer.Locate_3 method

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

Locates the shape nearest to _pt that is within _prec.

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

Syntax

// C#
public ITGIS_ShapeAbstract Locate_3(
  ITPoint _pt,
  int _prec
);
' VisualBasic
Public Function Locate_3(
  ByVal _pt As ITPoint,
  ByVal _prec As Integer
) As ITGIS_ShapeAbstract
// Oxygene
public
  function Locate_3(
    _pt : ITPoint;
    _prec : Integer
  ) : ITGIS_ShapeAbstract;

Parameters

Name Type Description
_pt ITPoint Reference point in screen coordinates, expressed in pixels.
_prec int
Integer
Maximum search distance in pixels; 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

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/09/20 23:44

Page Tools