A synchronous (blocking) call which executes the specified delegate and returns a new Polyline at the location of a series of mouse clicks on the display, using the specified line color and width while tracking.

Namespace:  ESRI.ArcGISExplorer.Mapping
Assembly:  ESRI.ArcGISExplorer (in ESRI.ArcGISExplorer.dll) Version: 2.0.0.900 (2.0.0.900)

Syntax

C#
public Polyline TrackPolyline(
	Color color,
	double width,
	TrackDelegate trackDelegate
)
Visual Basic (Declaration)
Public Function TrackPolyline ( _
	color As Color, _
	width As Double, _
	trackDelegate As TrackDelegate _
) As Polyline

Parameters

color
Type: System.Drawing..::.Color
The color of the partially completed line shown during the tracking operation.
width
Type: System..::.Double
The width in pixels of the partially completed line shown during the tracking operation. Default is 1, maximum is 10.
trackDelegate
Type: ESRI.ArcGISExplorer.Mapping..::.TrackDelegate
A tracking delegate that contains a method to be called when the user interacts with the display.

Return Value

A new Polyline defined by a series of mouse clicks on the display.

Remarks

This method returns a user-clicked Polyline on the map, using the specified line color and width while tracking. The TrackDelegate allows mouse moves and tracking cancellation to be identified. This overload allows the same TrackDelegate method to be called from both this synchronous method and also the asynchronous MapDisplay.BeginTrackPolyline(TrackDelegate) method.

This method will block the user interface (UI) thread until the user has completed tracking the Polyline. The method can be cancelled if the ESC key is pressed after the method has been called or the CancelTracking()()() method is called; in this case the method will return nullNothingnullptra null reference (Nothing in Visual Basic).

Alternatively you may wish to try the asynchronous alternative BeginTrackPolyline(TrackDelegate), or the synchronous TrackPolyline()()() overload.

See Also

Relate Topics:
  TrackPolyline Method
  TrackPolyline Method (Color)
  TrackPolyline Method (Color, Double)
Created by Atop CHM to web converter,© 2009 all right reserved.