CreateMapFromItem Method (MapFactory)

In This Topic

Creates a new Map in the project using an item e.g. webmap, mxd etc. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Function CreateMapFromItem( _
   ByVal item As Item _
) As Map

public Map CreateMapFromItem( 
   Item item
)

Parameters

item: An ArcGIS.Desktop.Core.Item

Return Value

Map

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Remarks

You should always check using MapFactory.CanCreateMapFrom() method before passing an item to this method.
To open a map, use ProApp.Panes.CreateMapPaneAsync method.

Example

BrowseDialogItems

{
  OpenItemDialog addToProjectDialog = new()
  {
    Title = "Add To Project",
    MultiSelect = true,
    Filter = ItemFilters.Composite_Maps_Import
  };
  bool? ok = addToProjectDialog.ShowDialog();
  if (ok == true)
  {
    IEnumerable<Item> selectedDialogItems = addToProjectDialog.Items;
    foreach (Item selectedDialogItem in selectedDialogItems)
      MapFactory.Instance.CreateMapFromItem(selectedDialogItem);
  }
}

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

MapFactory Class
MapFactory Members

Send feedback