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

IMap.SelectByShape Method (ArcObjects .NET 10.7 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IM > IMap Interface > IMap.SelectByShape Method
ArcGIS Developer Help

IMap.SelectByShape Method

Selects features in the map given a shape and a selection environment (optional).

[Visual Basic .NET]
Public Sub SelectByShape ( _
    ByVal Shape As IGeometry, _
    ByVal env As ISelectionEnvironment, _
    ByVal justOne As Boolean _
public void SelectByShape (
    IGeometry Shape,
    ISelectionEnvironment env,
    bool justOne
HRESULT SelectByShape(
  IGeometry* Shape,
  ISelectionEnvironment* env,
Shape [in]

Shape is a parameter of type IGeometry* env [in]
env is a parameter of type ISelectionEnvironment* justOne [in]
justOne is a parameter of type bool

Product Availability

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


SelectByShape searches for features in all layers of type IFeatureLayer, that are intersected by the input shape.  Each layer is searched only if its IFeatureLayer::Selectable property is set to TRUE. 

The ISelectionEnvironment parameter determines the selection outcome.  For example, a new selection may be created or the features found may be added to the existing feature selection.  See the esriSelectionOption enumeration for the different selection options.  The application's selection environment is available via IMxApplication::SelectionEnvironment.

The justOne parameter tells the search to stop once it has found one feature.

After the search is complete, IActiveViewEvents::SelectionChanged is called to notify all listeners the selection has changed.

See Also

IMap Interface