User Tools

Site Tools


api:dk11:activex:tatukgis_xdk11.itgis_layervector.locate_2_itgis_point_double_wordbool

Table of Contents

ITGIS_LayerVector.Locate_2 method

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

Locates a shape.

Available also on: Delphi | .NET | Java.

Syntax

// C#
public ITGIS_Shape 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_Shape
// Oxygene
public
  function Locate_2(
    _ptg : ITGIS_Point;
    _prec : Double;
    _visible : WordBool
  ) : ITGIS_Shape;

Parameters

Name Type Description
_ptg ITGIS_Point reference point /searching point/; 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
Double
precision /not a longer distance than/; 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 _prec units are calculated same way as _ptg
_visible WordBool if true the only visible shapes will be evaluated; shapes turned of by query of hidden will be ignored

Result

Type Description
ITGIS_Shape Found shape or nil.

Remarks

Use this method to locate a shape that is closest to point _ptg but also on _prec distance. Internally it calls LocateEx method.

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.

2020/05/07 01:04