ZoomOrPanToCurrentLocation Method (MapDeviceLocationService)

In This Topic

Zooms or pans the active map view to the current location, keeping the current device location at the center. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public void ZoomOrPanToCurrentLocation( 
   bool zoom
)

Public Sub ZoomOrPanToCurrentLocation( _
   ByVal zoom As Boolean _
)

Parameters

zoom: Set to true to zoom.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.InvalidOperationException	The active map view cannot be null

Remarks

There must be an active map view with an associated map or a System.InvalidOperationException will be thrown

Example

Zoom/Pan The Map To The Most Recent Location

//Must be on the QueuedTask.Run()

if (!MapDeviceLocationService.Instance.IsDeviceLocationEnabled)
  //Calling ZoomOrPanToCurrentLocation w/ no Device Location Enabled
  //Will throw an InvalidOperationException
  return;

// true for zoom, false for pan
MapDeviceLocationService.Instance.ZoomOrPanToCurrentLocation(true);

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.0 or higher.

Reference

MapDeviceLocationService Class
MapDeviceLocationService Members

Send feedback