A synchronous (blocking) call which executes the specified delegate and returns a new Polygon 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 Polygon TrackPolygon(
	Color color,
	double width,
	TrackDelegate trackDelegate
)
Visual Basic (Declaration)
Public Function TrackPolygon ( _
	color As Color, _
	width As Double, _
	trackDelegate As TrackDelegate _
) As Polygon

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 Polygon defined by a series of mouse clicks on the display.

Remarks

This method returns a user-clicked polygon 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.BeginTrackPolygon(TrackDelegate) method.

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

See Also

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