CreateMap(String,MapType,MapViewingMode,Basemap) Method

Creates a new Map in the project. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public Map CreateMap( 
   string name,
   MapType mapType,
   MapViewingMode defaultViewingMode,
   Basemap basemap
)

Public Overloads Function CreateMap( _
   ByVal name As String, _
   Optional ByVal mapType As MapType, _
   Optional ByVal defaultViewingMode As MapViewingMode, _
   Optional ByVal basemap As Basemap _
) As Map

Parameters

name: The name of the map
mapType: ArcGIS.Core.CIM.MapType (Optional) The type of the map. (default value = MapType.Map)
defaultViewingMode: ArcGIS.Core.CIM.MapViewingMode (Optional) Map's default viewing mode. (default value = MapViewingMode.Map)
basemap: Basemap (Optional) Map's basemap which can be the one that is set as the default for the project or one of the ArcGIS Online basemaps. If you want create a map without basemap, set it to Basemap.None. (default value = Basemap.ProjectDefault)

Return Value

A map.Map

Exceptions

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

Remarks

To open a map, use ProApp.Panes.CreateMapPaneAsync method.

Example

Create a new map with the default basemap layer.

await QueuedTask.Run(() =>
{
  var map = MapFactory.Instance.CreateMap(mapName, basemap: Basemap.ProjectDefault);
  //TODO: use the map...
});

Requirements

Target Platforms: Windows 10, Windows 8.1

Reference

MapFactory Class
MapFactory Members
Overload List