User Tools

Site Tools


api:dk11:delphi:gisinterfaces.igis_viewer.locate_tpoint_integer

Table of Contents

IGIS_Viewer.Locate(TPoint; Integer) method

DK11 for Delphi | GisInterfaces.IGIS_Viewer.Locate | Overloads | Methods | Properties

Locate a shape that is near _pt, but is closer than _prec distance.

Available also on: .NET | Java | ActiveX.

Syntax

// Delphi
public
  function Locate(
    const _pt : TPoint;
    const _prec : Integer
  ) : TGIS_ShapeAbstract; overload;
// C++ Builder
public:
  TGIS_ShapeAbstract* Locate(
    TPoint* const _pt,
    const int _prec
  ) = 0 /* overload */;

Parameters

Name Type Description
_pt TPoint reference point /searching point/ in pixels
_prec Integer 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; precision is express in pixels

Result

Type Description
TGIS_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.

2018/02/17 00:05