ZoomToSelected Method (MapView)

In This Topic

Zoom the view to the extent of the selected features in the map or scene. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public bool ZoomToSelected( 
   Nullable<TimeSpan> duration,
   bool maintainViewDirection
)

Public Function ZoomToSelected( _
   Optional ByVal duration As Nullable(Of TimeSpan), _
   Optional ByVal maintainViewDirection As Boolean _
) As Boolean

Parameters

duration: The amount of time to navigate the view to the new camera position. If null it uses the default navigation duration.
maintainViewDirection: Indicates if the Pitch and Heading should remain the same after the navigation is completed. If false the Heading will be set to 15.0 and the Pitch will be set to -60.0. This parameter only effects 3D views.

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.

Example

Zoom To Selected Features

public Task<bool> ZoomToSelected()
{
  return QueuedTask.Run(() =>
  {
    //Get the active map view.
    var mapView = MapView.Active;
    if (mapView == null)
      return false;

    //Zoom to the map's selected features.
    return mapView.ZoomToSelected();
  });
}

public Task<bool> ZoomToSelectedAsync()
{
  //Get the active map view.
  var mapView = MapView.Active;
  if (mapView == null)
    return Task.FromResult(false);

  //Zoom to the map's selected features.
  return mapView.ZoomToSelectedAsync(TimeSpan.FromSeconds(2));
}

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.0 or higher.

Reference

MapView Class
MapView Members

Send feedback