PanTo(Geometry,Nullable<TimeSpan>) Method

In This Topic

Syntax
Exceptions
Remarks
Example
Requirements
See Also

Pan the view to the extent defined by a geometry. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public bool PanTo( 
   Geometry geometry,
   Nullable<TimeSpan> duration
)

Public Overloads Function PanTo( _
   ByVal geometry As Geometry, _
   Optional ByVal duration As Nullable(Of TimeSpan) _
) As Boolean

Parameters

geometry: The geometry defining the extent in which to pan.
duration: The amount of time to navigate the view to the new camera position. If null it uses the default navigation duration.

Return Value

True if the navigation is completed, false if it was interrupted by another view navigation.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Remarks

Pan in 2D maintains the current camera scale and heading and modifies the X and Y position. Pan in 3D maintains the current camera pitch and heading and modifies the X and Y position. If the geometry's spatial reference is in a different spatial reference than the map this method projects the geometry into the spatial reference of the map.

Example

Pan To Extent Synchronous

public Task<bool> PanToExtentAsync(double xMin, double yMin, double xMax, double yMax, ArcGIS.Core.Geometry.SpatialReference spatialReference)
{
  return QueuedTask.Run(() =>
  {
    //Get the active map view.
    var mapView = MapView.Active;
    if (mapView == null)
      return false;

    //Pan the view to a given extent.
    var envelope = ArcGIS.Core.Geometry.EnvelopeBuilderEx.CreateEnvelope(xMin, yMin, xMax, yMax, spatialReference);
    return mapView.PanTo(envelope);
  });
}

Pan To an Extent

public Task<bool> PanToExtent(double xMin, double yMin, double xMax, double yMax, ArcGIS.Core.Geometry.SpatialReference spatialReference)
{
  return QueuedTask.Run(() =>
  {
    //Get the active map view.
    var mapView = MapView.Active;
    if (mapView == null)
      return false;

    //Pan the view to a given extent.
    var envelope = ArcGIS.Core.Geometry.EnvelopeBuilderEx.CreateEnvelope(xMin, yMin, xMax, yMax, spatialReference);
    return mapView.PanTo(envelope);
  });
}

public Task<bool> PanToExtentAsync(double xMin, double yMin, double xMax, double yMax, ArcGIS.Core.Geometry.SpatialReference spatialReference)
{
  //Get the active map view.
  var mapView = MapView.Active;
  if (mapView == null)
    return Task.FromResult(false);

  //Create the envelope
  var envelope = ArcGIS.Core.Geometry.EnvelopeBuilderEx.CreateEnvelope(xMin, yMin, xMax, yMax, spatialReference);

  //Pan the view to a given extent.
  return mapView.PanToAsync(envelope, TimeSpan.FromSeconds(2));
}

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

ArcGIS Pro version: 2.0 or higher.

Reference

MapView Class
MapView Members
Overload List

Send feedback