ArcGIS Pro 3.0 API Reference Guide
ArcGIS.Desktop.Core Namespace / FrameworkExtender Class / CreateMapPaneAsync Method / CreateMapPaneAsync(PaneCollection,Map,Nullable<MapViewingMode>,TimeRange) Method
The project's collection of panes returned from ArcGIS.Desktop.Framework.FrameworkApplication.Panes.
The map to display in the view.
Specifies the perspective of the view.
Sets the time extent for the view.
Example

In This Topic
    CreateMapPaneAsync(PaneCollection,Map,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
    Public Overloads Shared Function CreateMapPaneAsync( _
       ByVal paneCollection As PaneCollection, _
       ByVal map As Map, _
       Optional ByVal viewingMode As Nullable(Of MapViewingMode), _
       Optional ByVal timeExtent As TimeRange _
    ) As Task(Of IMapPane)

    Parameters

    paneCollection
    The project's collection of panes returned from ArcGIS.Desktop.Framework.FrameworkApplication.Panes.
    map
    The map to display in 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
    ExceptionDescription
    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
    public static async Task<Map> FindOpenExistingMapAsync(string mapName)
    {
      return await QueuedTask.Run(async () =>
      {
        Map map = null;
        Project proj = Project.Current;
    
        //Finding the first project item with name matches with mapName
        MapProjectItem mpi =
            proj.GetItems<MapProjectItem>()
                .FirstOrDefault(m => m.Name.Equals(mapName, StringComparison.CurrentCultureIgnoreCase));
        if (mpi != null)
        {
          map = mpi.GetMap();
          //Opening the map in a mapview
          await ProApp.Panes.CreateMapPaneAsync(map);
        }
        return map;
      });
    
    }
    Open a webmap
    Map map = null;
    
    //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, Windows 10, Windows 8.1

    See Also