ArcObjects Library Reference (Controls)  

IMapControl3.TrackPolygon Method

Rubber-bands a polygon on the MapControl.

ERROR: Syntax information about IMapControl3.TrackPolygon may not be in D:\ArcGIS\DotNet\ESRI.ArcGIS.Controls.dll

[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

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