ArcGIS Developer Help

IConnectedCells.Locate Method

[Visual Basic .NET]
Public Sub Locate ( _
    ByVal searchShape As IGeometry, _
    ByVal Foreground As Boolean, _
    ByVal spatialRelMethod As Integer, _
    ByVal callbackSel As INotifySelectionBlock, _
    ByVal trackCancel As ITrackCancel, _
    ByVal stepProgressor As IStepProgressor _
)

[C#]
public void Locate (
    IGeometry searchShape,
    bool Foreground,
    int spatialRelMethod,
    INotifySelectionBlock callbackSel,
    ITrackCancel trackCancel,
    IStepProgressor stepProgressor
);

Available with ArcGIS Desktop. Requires ArcScan Extension.

[C#]

The following code shows an example of this method in C#.

//You can get app from ICommand :: OnCreate() hook parameter

public void Locate()
{
  IConnectedCells connectedCells = app.FindExtensionByName("ESRI ArcScan Tools") as IConnectedCells;
  IMxDocument mxDoc = app.Document as IMxDocument;
  INotifySelectionBlock foundBlock = new FoundBlock();

  ESRI.ArcGIS.Geometry.IPoint currentPoint = new ESRI.ArcGIS.Geometry.Point();
  currentPoint.PutCoords(39.2, 37.4);

  connectedCells.Locate(currentPoint.Envelope, true, 1, foundBlock, null, null);
}

Also create a new class (FoundBlock) with the following code.

public class FoundBlock : ESRI.ArcGIS.ArcScan.INotifySelectionBlock 
{
  public FoundBlock()
  { 
  }
  #region INotifySelectionBlock Members
  void ESRI.ArcGIS.ArcScan.INotifySelectionBlock.SelectionBlock(ref ESRI.ArcGIS.Display.tagRECT rectangle, object block, ESRI.ArcGIS.esriSystem.ITrackCancel cancel)
  {
    System.Diagnostics.Debug.Print("Found block");
  }
  #endregion
}