CreateMapPaneAsync(PaneCollection,Map,Envelope,Nullable<MapViewingMode>,TimeRange) Method

In This Topic

Create and activate a new map pane which is a container for a ArcGIS.Desktop.Mapping.MapView.

Syntax

Visual Basic (Declaration)
C#

Public Overloads Shared Function CreateMapPaneAsync( _
   ByVal paneCollection As PaneCollection, _
   ByVal map As Map, _
   ByVal extent As Envelope, _
   Optional ByVal viewingMode As Nullable(Of MapViewingMode), _
   Optional ByVal timeExtent As TimeRange _
) As Task(Of IMapPane)

public static Task<IMapPane> CreateMapPaneAsync( 
   PaneCollection paneCollection,
   Map map,
   Envelope extent,
   Nullable<MapViewingMode> viewingMode,
   TimeRange timeExtent
)

Parameters

paneCollection: The project's collection of panes returned from ArcGIS.Desktop.Framework.FrameworkApplication.Panes.
map: The map to display in the resulting view.
extent: Sets the extent of the view.
viewingMode: Specifies the perspective of the view.
timeExtent: Sets the time extent for the view.

Return Value

A Task returning a map pane.

Exceptions

Exception	Description
System.InvalidOperationException	Map can only be set for 2D views and SceneLocal and SceneGlobal can only be set for 3D views.

Remarks

When a new map pane is created the ArcGIS.Desktop.Mapping.MapView needs to initialize before any operations are performed on it. Be sure to await the Task to ensure the view has finished its initialization before performing any operations on the resulting ArcGIS.Desktop.Mapping.MapView.

Example

Find a map within a project and open it

{
    //Finding the first project item with name matches with mapName
    MapProjectItem? mpi = Project.Current.GetItems<MapProjectItem>()
      .FirstOrDefault(m => m.Name.Equals("The Map", StringComparison.CurrentCultureIgnoreCase));
    //Note: Needs QueuedTask to run
    var mapFromItem = mpi?.GetMap();
    if (mapFromItem != null)
    {
        //Open the map in a new map pane
        //Must be called from the UI thread
        await ProApp.Panes.CreateMapPaneAsync(map);
    }
}

Open a webmap

{
    //Assume we get the selected webmap from the Project pane's Portal tab
    if (Project.Current.SelectedItems.Count > 0)
    {
        if (MapFactory.Instance.CanCreateMapFrom(Project.Current.SelectedItems[0]))
        {
            map = MapFactory.Instance.CreateMapFromItem(Project.Current.SelectedItems[0]);
            await ProApp.Panes.CreateMapPaneAsync(map);
        }
    }
}

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

FrameworkExtender Class
FrameworkExtender Members
Overload List

Send feedback