ZoomToAsync(Bookmark,Nullable<TimeSpan>) Method

In This Topic

Zoom the view to the position defined in a bookmark.

Syntax

Visual Basic (Declaration)
C#

Public Overloads Function ZoomToAsync( _
   ByVal bookmark As Bookmark, _
   Optional ByVal duration As Nullable(Of TimeSpan) _
) As Task(Of Boolean)

public Task<bool> ZoomToAsync( 
   Bookmark bookmark,
   Nullable<TimeSpan> duration
)

Parameters

bookmark: The bookmark containing the position in which to zoom.
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.

Example

Zoom Async To Bookmark by name

{
  // Note: Needs QueuedTask to run
  //Get the first bookmark with the given name.
  var bookmark = mapView.Map.GetBookmarks().FirstOrDefault(b => b.Name == bookmarkName);
  if (bookmark == null)
  {
    // Manage the error - bookmark not found
  }

  //Zoom the view to the bookmark.
  mapView.ZoomToAsync(bookmark, TimeSpan.FromSeconds(2));
}

Rotate the map view

{
  //Get the camera for the view, adjust the heading and zoom to the new camera position.
  camera = mapView.Camera;
  camera.Heading = heading;
  await mapView.ZoomToAsync(camera, TimeSpan.Zero);
  //Or synchronously
  mapView.ZoomTo(camera, TimeSpan.Zero);
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

MapView Class
MapView Members
Overload List

Send feedback