Table of Contents
ITGIS_LayerVector.Locate method
DK for ActiveX | TatukGIS_XDK11.ITGIS_LayerVector.Locate | Methods | Properties
Locates the nearest shape to a reference point within the specified tolerance distance.
Syntax
// C# public ITGIS_Shape Locate( ITGIS_Point _ptg, double _prec );
' VisualBasic Public Function Locate( ByVal _ptg As ITGIS_Point, ByVal _prec As Double ) As ITGIS_Shape
// Oxygene public function Locate( _ptg : ITGIS_Point; _prec : Double ) : ITGIS_Shape;
Parameters
| Name | Type | Description |
|---|---|---|
| _ptg | ITGIS_Point | Reference point used for the search. The coordinate space depends on the caller context and layer/viewer usage. |
| _prec | double Double | Maximum search distance. Shapes farther than this tolerance are not returned. |
Result
| Type | Description |
|---|---|
| ITGIS_Shape | The nearest matching shape, or nil if no shape is found within the specified tolerance. |
Remarks
PURPOSE: Supports interactive hit testing for vector features such as points, arcs/lines, and polygons.
BEHAVIOR: Searches candidate shapes near _ptg and returns the closest match within _prec. The search can use the layer's spatial index when available for faster lookup.
CONSTRAINTS: Distance is evaluated in the coordinate space supplied to the method. Results depend on the layer's current visibility and filtering rules.
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.