ArcObjects Library Reference (Controls)

IMapControl4.TrackPolygon Method

Rubber-bands a polygon on the MapControl.

[Visual Basic .NET]
Public Function TrackPolygon ( _
) As IGeometry

[C#]
public IGeometry TrackPolygon (
);

[C++]
HRESULT TrackPolygon(
  IGeometry** polygon
);

[C++]

Parameters
polygon [out, retval]

  polygon is a parameter of type IGeometry

Available with ArcGIS Engine.

TrackPolygon returns a geometry object that implements IPolygon.

Use the TrackPolygon method within the IMapControlEvents2::OnMouseDown event to rubberband a user defined polygon. The IMapControlEvents2::OnMouseMove event will be triggered during the track, but no IMapControlEvents2::OnMouseUp event will occur. The ESC key on the keyboard can be used during the track to cancel the TrackPolygon.

Calling ITopologicalOperator::Simplify on the digitized polygon will ensure that it is topologically correct.