User Tools

Site Tools


Table of Contents

ITGIS_LayerVector.LocateEx_2 method

DK11 for ActiveX | TatukGIS_XDK11.ITGIS_LayerVector.LocateEx_2 | Methods | Properties

Locates a shape (more precise).

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


// C#
public ITGIS_Shape LocateEx_2(
  ITGIS_Point _ptg,
  double _prec,
  OleVariant _uid,
  ref double _dist,
  ref int _part,
  ref ITGIS_Point _proj,
  WordBool _visible
' VisualBasic
Public Function LocateEx_2(
  ByVal _ptg As ITGIS_Point,
  ByVal _prec As Double,
  ByVal _uid As OleVariant,
  ByRef _dist As Double,
  ByRef _part As Integer,
  ByRef _proj As ITGIS_Point,
  ByVal _visible As WordBool
) As ITGIS_Shape
// Oxygene
  function LocateEx_2(
    _ptg : ITGIS_Point;
    _prec : Double;
    _uid : OleVariant;
    var _dist : Double;
    var _part : Integer;
    var _proj : ITGIS_Point;
    _visible : WordBool
  ) : ITGIS_Shape;


Name Type Description
_ptg ITGIS_Point reference point /searching point/ in a layer; if the layer has been attached to the Viewer then expected _ptg units are in a Viewer coordinate space; otherwise expected _ptg units are in a Layer coordinate space
_prec double
precision /not a longer distance than/; point inside a polygon is always not greater than _dist; if _prec is less then 0, then being outside/inside polygon means the same; _prec units are calculated same way as _ptg
_uid OleVariant Uid of reference shape or -1; thanks to this, is possible to find nearest shape, excluding shape given by _uid.
_dist double
reached distance between _pt and shape in Result; for points inside the polygon (if _prec >= 0) the distance will be multiply by 0.95 (to prefer points inside the polygon) but will not be bigger then _prec; for point distance will be multiplied by 0.9 to prefer points over lines and polygons _dist units are calculated same way as _ptg
_part int
number of the part closest to a given point
_proj ITGIS_Point point projected to the nearest element of a shape
_visible WordBool if true the only visible shapes will be evaluated; shapes turned of by query of hidden will be ignored


Type Description
ITGIS_Shape Found shape or nil.


Use this method to locate a shape that is near _ptg but also on _prec distance. It finds a shape using FindFirst method in extent corrected by _prec and _ptg params.

If no shape is found on a layer, the searcher takes into account labels registered by the allocator (by extent). In order to disable this behavior, _visible must be set to False.

2022/11/16 01:10

Page Tools