ArcObjects Library Reference (Controls)

IMapControl3.TrackLine Method

Rubber-bands a polyline on the MapControl.

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

[C#]
public IGeometry TrackLine (
);

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

[C++]

Parameters
polyline [out, retval]

  polyline is a parameter of type IGeometry

Available with ArcGIS Engine.

TrackLine returns a geometry object that implements IPolyline.

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.