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


IMapControl4.TrackPolygon Method (ArcObjects .NET 10.5 SDK)
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

Product Availability

Available with ArcGIS Engine.

Description

TrackPolygon returns a geometry object that implements IPolygon.

Remarks

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.

See Also

IMapControl4 Interface | IMapControl4.TrackCircle Method | IMapControl3.TrackCircle Method | IMapControl2.TrackCircle Method | IMapControl2.TrackLine Method | IMapControl3.TrackLine Method | IMapControl4.TrackLine Method | IMapControl3.TrackRectangle Method | IMapControl4.TrackRectangle Method | IMapControl2.TrackRectangle Method