arcgis 线上到指定点的距离最短的一点/QueryPointAndDistance/ReturnNearestPoint

在ArcEngine中可以通过两种方式实现：

第一种：由ICurve和IPolyline接口的QueryPointAndDistance方法实现。  

           该方法中有七个参数，下面对这些参数进行详细说明：

          1.extension参数：esriSegmentExtension枚举类型，用于指定曲线段延伸的方式，主要有esriNoExtension（曲线段不做延伸）、esriExtendTangents等。延伸方式。

          2. inPoint参数：指输入点对象，IPoint类型，即要求该点到曲线的最短距离；
          3. asRatio参数：bool类型，指定从改方法得到的distanceAlongCurve参数（见后）的值是以占曲线总长度的比例的方式输出还是以绝对长度值输出；
          4. outPoint参数：输出点对象， IPoint类型，即所找到的曲线上到输入点距离最小的点，使用前只需先实例化；
          5. distanceAlongCurve参数：double类型，指曲线的FromPoint（起始点）到输出点（outPoint）的曲线长度，asRatio参数将影响改值的输出方式（比例还是绝对长度值）；
          6. distanceFromCurve参数：double类型，指输入点到曲线的最短距离；
          7.bRightSide参数：bool类型，指输入点是否在曲线的右方。
 

         代码示例(C#)：
          IPolyline i_poly = ... ;//已知曲线
          IPoint inPoint = ...; //已知点
          IPoint outPoint = new PointClass(); //曲线上到输入点距离最小的点；
          double distAlongCurveFrom = 0; //曲线起始点到输出点部分的长度
          double distFromCurve = 0;//输出点到输入点的距离
          bool isRightSide = false;//输入点是否在曲线的右边
          i_poly.QueryPointAndDistance(esriSegmentExtension.esriNoExtension, inPoint, false, outPoint, ref distAlongCurveFrom, ref distFromCurve, ref isRightSide);

第二种：由接口IProximityOperator的ReturnNearestPoint方法实现。  

           该方法中有两个参数，下面对这些参数进行详细说明：

          1. IPoint参数：指输入点对象，IPoint类型，即要求该点到曲线的最短距离；

          2. esriSegmentExtension参数：esriSegmentExtension类型；

 

          代码示例(C#)：

          IPolyline pPolyline = ...;
          IProximityOperator proOperator = pPolyline as IProximityOperator;
          position = proOperator.ReturnNearestPoint(clickPoint, esriSegmentExtension.esriNoExtension);