ArcObjects Library Reference (Controls)  

IMapControl2.TrackLine Method

Rubber-bands a polyline on the MapControl.

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

[C++]
HRESULT TrackLine(
  IGeometry** polyline
);
[C++]

Parameters

polyline [out, retval]

  polyline is a parameter of type IGeometry

Product Availability

Available with ArcGIS Engine.

Description

TrackLine returns a geometry object that implements IPolyline.

Remarks

Use the TrackLine method within the IMapControlEvents2::OnMouseDown event to rubberband a user defined line. 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 TrackLine.

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

See Also

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