ZoomToElements Method (LayoutView)

In This Topic

Zoom to the extent of the elements. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public bool ZoomToElements( 
   IEnumerable<Element> elements,
   Nullable<TimeSpan> duration
)

Public Function ZoomToElements( _
   ByVal elements As IEnumerable(Of Element), _
   Optional ByVal duration As Nullable(Of TimeSpan) _
) As Boolean

Parameters

elements: The set of elements to zoom to.
duration: The amount of time to navigate the view to the new camera position. If null it uses the default navigation duration.

Return Value

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

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method must be called within the lambda passed to QueuedTask.Run.
System.ArgumentNullException	The value cannot be null: elements

Example

Zoom to elements

LayoutView lytView = LayoutView.Active;
//Zoom to an element
var elementToZoomTo = layout.FindElements(new List<string>() { "MyPoint" }).FirstOrDefault();
lytView.ZoomToElement(elementToZoomTo);
//Zoom to  multiple elements.
var elementsToZoomTo = layout.FindElements(new List<string>() { "Point 1", "Line 3", "Text 1" });
lytView.ZoomToElements(elementsToZoomTo);

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

LayoutView Class
LayoutView Members

Send feedback