A synchronous (blocking) call which executes the specified delegate and returns a new vector (Polyline with two points) at the location of a series of two 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 TrackVector(
	Color color,
	double width,
	TrackDelegate trackDelegate
)
Visual Basic (Declaration)
Public Function TrackVector ( _
	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 two mouse clicks on the display.

Remarks

This method returns a user-clicked vector on the map, using the specified line color and width while tracking. A vector is a special case of a Polyline with exactly two points, used only in ArcGIS Explorer during tracking operations (there is no vector geometry type). 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.BeginTrackVector(TrackDelegate) method.

This method will block the user interface (UI) thread until the user has completed tracking the vector. 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 BeginTrackVector(TrackDelegate), or the synchronous TrackVector()()() overload.

See Also

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