ZoomToAsync(Bookmark,Nullable<TimeSpan>) Method

In This Topic

Zoom the view to the position defined in a bookmark.

Syntax

C#
Visual Basic (Declaration)

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

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

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 To Bookmark by name

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

    //Get the first bookmark with the given name.
    var bookmark = mapView.Map.GetBookmarks().FirstOrDefault(b => b.Name == bookmarkName);
    if (bookmark == null)
      return false;

    //Zoom the view to the bookmark.
    return mapView.ZoomTo(bookmark);
  });
}

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

  //Get the first bookmark with the given name.
  var bookmark = await QueuedTask.Run(() => mapView.Map.GetBookmarks().FirstOrDefault(b => b.Name == bookmarkName));
  if (bookmark == null)
    return false;

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

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.0 or higher.

Reference

MapView Class
MapView Members
Overload List

Send feedback