IGIS_Viewer.Locate(TGIS_Point; Double; Boolean) method

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

Locates the shape nearest to _ptg that is within _prec.

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

// Delphi
public
  function Locate(
    const _ptg : TGIS_Point;
    const _prec : Double;
    const _visible : Boolean
  ) : TGIS_ShapeAbstract; overload;

// C++ Builder
public:
  TGIS_ShapeAbstract* Locate(
    TGIS_Point* const _ptg,
    const double _prec,
    const bool _visible
  ) = 0 /* overload */;

To improve performance, use section visibility to choose the layer on which to call Locate. When _visible is True, only visible shapes are evaluated.

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.