api:dk11:activex:tatukgis_xdk11.igis_viewer.locate_2_itgis_point_double_wordbool
Table of Contents
IGIS_Viewer.Locate_2 method
DK for ActiveX | TatukGIS_XDK11.IGIS_Viewer.Locate_2 | Methods | Properties
Locates the shape nearest to _ptg that is within _prec.
Syntax
// C# public ITGIS_ShapeAbstract 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_ShapeAbstract
// Oxygene public function Locate_2( _ptg : ITGIS_Point; _prec : Double; _visible : WordBool ) : ITGIS_ShapeAbstract;
Parameters
| Name | Type | Description |
|---|---|---|
| _ptg | ITGIS_Point | Reference point in map coordinates. |
| _prec | double Double | Maximum search distance in map units; distances for points inside polygons are multiplied by 0.95 and point distances are multiplied by 0.9 to prefer points over lines and polygons. |
| _visible | WordBool | If True, only visible shapes are evaluated; shapes hidden by query or visibility settings are ignored. |
Result
| Type | Description |
|---|---|
| ITGIS_ShapeAbstract | Located shape or nil. |
Remarks
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.
2026/09/20 23:44