This document is archived and information here might be outdated.  Recommended version.

ITopologyGraph.HitTestSelection Method (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geodatabase > ESRI.ArcGIS.GeoDatabase > Interfaces > IT > ITopologyGraph Interface > ITopologyGraph.HitTestSelection Method
ArcGIS Developer Help

ITopologyGraph.HitTestSelection Method

Locates an element of the graph's selection nearest to the query point that is also within searchRadius units of it; whichElements is a bitwise combination of esriTopologyElement values.

[Visual Basic .NET]
Public Function HitTestSelection ( _
    ByVal whichElements As Integer, _
    ByVal QueryPoint As IPoint, _
    ByVal searchRadius As Double, _
    ByVal hitPoint As IPoint, _
    ByRef hitDistance As Double, _
    ByRef hitElement As ITopologyElement _
) As Boolean
public bool HitTestSelection (
    int whichElements,
    IPoint QueryPoint,
    double searchRadius,
    IPoint hitPoint,
    ref double hitDistance,
    ref ITopologyElement hitElement
HRESULT HitTestSelection(
  long whichElements,
  IPoint* QueryPoint,
  double searchRadius,
  IPoint* hitPoint,
  System.Double* hitDistance,
  ITopologyElement** hitElement
whichElements [in]

whichElements is a parameter of type long QueryPoint [in]
QueryPoint is a parameter of type IPoint* searchRadius [in]
searchRadius is a parameter of type double hitPoint [in]
hitPoint is a parameter of type IPoint* hitDistance [out]
hitDistance is a parameter of type double* hitElement [out]
hitElement is a parameter of type ITopologyElement**

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.


The ITopologyGraph::HitTestSelection method allows to retrieve the nearest TopologyElement (TopologyNode or TopologyEdge) part of the TopologyGraph selection located within a distance from an input point. This could be used to get a TopologyElement based on a user mouse click. It returns a reference to the nearest TopologyElement object, the point where the TopologyElement was hit and the distance from the hit point to the input point. The search radius distance must use the same distance units as the Topology or MapTopology units no conversion is performed if they are not the same.


For more information about how to use this method, such as an example and how to retrieve a hit point, see the HitTest method.

Note: whichElements is a bitwise combination of esriTopologyElement values.

See Also

ITopologyGraph Interface