menu

WPF

  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class SfMap - WPF API Reference | Syncfusion

    Show / Hide Table of Contents

    Class SfMap

    true Syncfusion controls for Metro Syncfusion controls for Metro

    Inheritance
    System.Object
    SfMap
    Implements
    System.IDisposable
    Namespace: Syncfusion.UI.Xaml.Maps
    Assembly: Syncfusion.SfMaps.WPF.dll
    Syntax
    public class SfMap : Control, IDisposable

    Constructors

    SfMap()

    Creates a new Instance for the SfMap.And initialize its values.

    Declaration
    public SfMap()

    Fields

    BaseMapIndexProperty

    // Using a DependencyProperty as the backing store for BaseMapIndex. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty BaseMapIndexProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    EnableLayerChangeAnimationProperty

    // Using a DependencyProperty as the backing store for EnableLayerChangeAnimation. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty EnableLayerChangeAnimationProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    EnablePanProperty

    // Using a DependencyProperty as the backing store for EnablePan. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty EnablePanProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    EnableZoomOnSelectionProperty

    // Using a DependencyProperty as the backing store for EnableZoomOnSelection. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty EnableZoomOnSelectionProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    EnableZoomProperty

    // Using a DependencyProperty as the backing store for EnableZoom. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty EnableZoomProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    HeaderProperty

    // Using a DependencyProperty as the backing store for Header. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty HeaderProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    LatitudeLongitudeTypeProperty

    // Using a DependencyProperty as the backing store for LatitudeLongitudeType. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty LatitudeLongitudeTypeProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    LayersProperty

    // Using a DependencyProperty as the backing store for Layers. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty LayersProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    LegendSettingsProperty

    Using a DependencyProperty as the backing store for LegendSettings. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty LegendSettingsProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    MapCoordsProperty

    // Using a DependencyProperty as the backing store for MapCoords. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty MapCoordsProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    MapResourceDictionaryProperty

    Dependency registration for Syncfusion.UI.Xaml.Maps.SfMap.MapResourceDictionary

    Declaration
    public static readonly DependencyProperty MapResourceDictionaryProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    MapStyleProperty

    // Using a DependencyProperty as the backing store for MapStyle. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty MapStyleProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    MaxZoomProperty

    // Using a DependencyProperty as the backing store for MaxZoom. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty MaxZoomProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    MinZoomProperty

    // Using a DependencyProperty as the backing store for MinZoom. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty MinZoomProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    NavigationControlPositionProperty

    // Using a DependencyProperty as the backing store for NavigationControlPosition. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty NavigationControlPositionProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    NavigationControlScaleProperty

    // Using a DependencyProperty as the backing store for NavigationControlScale. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty NavigationControlScaleProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    ShowCoordsProperty

    // Using a DependencyProperty as the backing store for ShowCoords. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty ShowCoordsProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    ShowNavigationControlProperty

    // Using a DependencyProperty as the backing store for ShowNavigationControl. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty ShowNavigationControlProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    ZoomFactorProperty

    Identifies ZoomFactor Dependency Property

    Declaration
    public static readonly DependencyProperty ZoomFactorProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    ZoomLevelProperty

    // Using a DependencyProperty as the backing store for ZoomLevel. This enables animation, styling, binding, etc...

    Declaration
    public static readonly DependencyProperty ZoomLevelProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    Properties

    BaseMapIndex

    Gets or sets the index of the layer which is loaded initially.

    Declaration
    public int BaseMapIndex { get; set; }
    Property Value
    Type Description
    System.Int32

    Type :System.Int32

    Remarks

    Use this property to set the initial layer to be loaded in the map.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();           
                SfMap syncMap = new SfMap();           
                ShapeFileLayer layer = new ShapeFileLayer();          
                layer.Uri = "MapApp.world1.shp";
                ShapeFileLayer layer1 = new ShapeFileLayer();
                layer.Uri = "MapApp.US.shp";
                syncMap.Layers.Add(layer);   
                syncMap.Layers.Add(layer1);
                syncMap.BaseMapIndex = 1;
            }
        }
    
    }

    EnableLayerChangeAnimation

    Gets or Sets EnableLayerChangeAnimation

    Declaration
    public bool EnableLayerChangeAnimation { get; set; }
    Property Value
    Type
    System.Boolean

    EnablePan

    Enables or disables the Panning feature of the map.

    Declaration
    public bool EnablePan { get; set; }
    Property Value
    Type Description
    System.Boolean

    Type :System.Boolean "True" value enables the Panning;And "False" will disable the Panning. Default Value is "True".

    Remarks

    Use this property to enable or disable the panning feature of the map. "True" value will enable the panning feature."False" value will disable the panning feature.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();           
                SfMap syncMap = new SfMap();
                syncMap.EnablePan = false;
                ShapeFileLayer layer = new ShapeFileLayer();          
                layer.Uri = "MapApp.world1.shp";          
                syncMap.Layers.Add(layer);            
            }
        }
    
    }

    EnableZoom

    Enables or disables the Zooming feature of the map.

    Declaration
    public bool EnableZoom { get; set; }
    Property Value
    Type Description
    System.Boolean

    Type :System.Boolean "True" value enables the Zooming;And "False" will disable the Zooming. Default Value is "True".

    Remarks

    Use this property to enable or disable the zooming feature of the map. "True" value will enable the zoom feature."False" value will disable the zooming feature.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();           
                SfMap syncMap = new SfMap();
                syncMap.EnableZoom = false;
                ShapeFileLayer layer = new ShapeFileLayer();          
                layer.Uri = "MapApp.world1.shp";          
                syncMap.Layers.Add(layer);            
            }
        }
    
    }

    EnableZoomOnSelection

    Enables or disables the ZoomOnSelection feature of the map.

    Declaration
    public bool EnableZoomOnSelection { get; set; }
    Property Value
    Type Description
    System.Boolean

    Type :System.Boolean "True" value enables the Zooming;And "False" will disable the Zooming. Default Value is "True".

    Remarks

    Use this property to enable or disable the zoom on selection feature of the map. "True" value will enable the zoom on selection feature."False" value will disable the zoom on selection feature.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();           
                SfMap syncMap = new SfMap();
                syncMap.EnableZoomOnSelection = false;
                ShapeFileLayer layer = new ShapeFileLayer();          
                layer.Uri = "MapApp.world1.shp";          
                syncMap.Layers.Add(layer);            
            }
        }
    
    }

    Header

    Gets or sets the Header of the SfMap.

    Declaration
    public object Header { get; set; }
    Property Value
    Type Description
    System.Object

    Type :System.Object

    Remarks

    Use this property to set the header for the SfMap. Header is the title which shown on top of the SfMap.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();           
                SfMap syncMap = new SfMap();
                syncMap.Header = new TextBlock { Text="World SfMap", HorizontalAlignment=HorizontalAlignment.Center,VerticalAlignment=VerticalAlignment.Center };
                ShapeFileLayer layer = new ShapeFileLayer();          
                layer.Uri = "MapApp.world1.shp";          
                syncMap.Layers.Add(layer);            
            }
        }
    
    }

    LatitudeLongitudeType

    Gets or sets display type of LatitudeLangitude values on the top right of the map.

    Declaration
    public LatLonType LatitudeLongitudeType { get; set; }
    Property Value
    Type Description
    LatLonType

    Type :LatLonType

    Remarks

    Use this property to determine how to display the latitude values. There are two types,

    DMS and Decimal

    Decimal will be shown as normal numbers.

    DMS will be shown as Degrees,Minutes and Seconds.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                syncMap.LatitudeLongitudeType = LatLonType.Decimal;
                syncMap.LatitudeLongitudeType = LatLonType.DMS;
                syncMap.Layers.Add(layer);
    
            }
        }
    
    }

    Layers

    Gets or sets the Layers for the map. Layers are the content for the map.

    Declaration
    public ObservableCollection<MapLayer> Layers { get; set; }
    Property Value
    Type
    System.Collections.ObjectModel.ObservableCollection<MapLayer>
    Remarks

    Use this property to add or remove the layers of the map. Each layer in Layers are the container of the map elements.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();           
                SfMap syncMap = new SfMap();           
                ShapeFileLayer layer = new ShapeFileLayer();          
                layer.Uri = "MapApp.world1.shp";          
                syncMap.Layers.Add(layer);            
            }
        }
    
    }

    LegendSettings

    Gets or Sets LegendSetting

    Declaration
    public LegendSetting LegendSettings { get; set; }
    Property Value
    Type
    LegendSetting

    MapCoords

    Gets the co ordinates of the map in terms of latitude and longitude values.

    Declaration
    public Point MapCoords { get; }
    Property Value
    Type Description
    System.Windows.Point

    Type :System.Windows.Point

    Remarks

    This is read only property to get the current latitude and longitude values when hovering on the map.

    MapStyle

    Gets or sets the style for the map.

    Declaration
    public Style MapStyle { get; set; }
    Property Value
    Type Description
    System.Windows.Style

    Type :System.Windows.Style

    MaxZoom

    Gets or sets the maximum zoom level of the map.

    Declaration
    public int MaxZoom { get; set; }
    Property Value
    Type Description
    System.Int32

    Type : System.Int32

    Remarks

    Use this property to set the maximum zoom level of the map. The map cannot be zoomed beyond the MaxZoom value.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();           
                SfMap syncMap = new SfMap();
                syncMap.MaxZoom = 30;
                ShapeFileLayer layer = new ShapeFileLayer();          
                layer.Uri = "MapApp.world1.shp";          
                syncMap.Layers.Add(layer);            
            }
        }
    
    }

    MinZoom

    Gets or sets the minimum zoom level of the map.

    Declaration
    public int MinZoom { get; set; }
    Property Value
    Type Description
    System.Int32

    Type :System.Int32

    Default value will be 1.

    Remarks

    Use this property to set the minimum zoom level of the map. The map cannot be zoomed out below the MinZoom.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();           
                SfMap syncMap = new SfMap();
                syncMap.MinZoom = 3;
                ShapeFileLayer layer = new ShapeFileLayer();          
                layer.Uri = "MapApp.world1.shp";          
                syncMap.Layers.Add(layer);            
            }
        }
    
    }

    NavigationControlPosition

    Gets or Sets NavigationControlPosition to the Maps

    Declaration
    public NavigationControlPositions NavigationControlPosition { get; set; }
    Property Value
    Type
    NavigationControlPositions

    NavigationControlScale

    Gets or Sets NavigationControlScale for Map

    Declaration
    public double NavigationControlScale { get; set; }
    Property Value
    Type
    System.Double

    PanCommand

    Gets the command for panning the map.

    Declaration
    public ICommand PanCommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    Type :System.Windows.Input.ICommand

    Remarks

    Use this command to pan the map. Command parameter will specify the direction to be panned.

    There are four command parameters can be given,

    Left,Right,Top and Bottom

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                Button topPan = new Button();
                topPan.Command = syncMap.PanCommand;
                topPan.CommandParameter = "Top";
                Button bottomPan = new Button();
                bottomPan.Command = syncMap.PanCommand;
                bottomPan.CommandParameter = "Bottom";
                Button leftPan = new Button();
                leftPan.Command = syncMap.PanCommand;
                leftPan.CommandParameter = "Left";
                Button rightPan = new Button();
                rightPan.Command = syncMap.PanCommand;
                rightPan.CommandParameter = "Right";
                syncMap.Layers.Add(layer);
            }
        }    
    }

    PanResetCommand

    Gets the command for resetting the pan values.

    Declaration
    public ICommand PanResetCommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    Type :System.Windows.Input.ICommand

    Remarks

    Use this command to reset the pan values of the map.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                Button cmdButton = new Button();
                cmdButton.Command = syncMap.PanResetCommand;
                syncMap.Layers.Add(layer);
            }
        }    
    }

    RefreshCommand

    Gets the Refresh Command for the Maps.Invokes refresh functionality of the map.

    Declaration
    public ICommand RefreshCommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    Type :System.Windows.Input.ICommand

    Remarks

    Use this command to refresh the map.While refreshing the map, all elements will be cleared then added again.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                Button cmdButton = new Button();
                cmdButton.Command = syncMap.RefreshCommand;
                syncMap.Layers.Add(layer);
            }
        }    
    }

    ResetCommand

    Gets the ResetCommand for SfMap..

    Declaration
    public ICommand ResetCommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    Type System.Windows.Input.ICommand

    Remarks

    Use this property to invoke Reset command of the map. This command will clear all the elements of the map.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                Button cmdButton = new Button();
                cmdButton.Command = syncMap.ResetCommand;
                syncMap.Layers.Add(layer);
            }
        }    
    }

    ShowCoords

    Gets or sets a value indicating whether the latitude and longitude value can be viewed or not.

    Declaration
    public bool ShowCoords { get; set; }
    Property Value
    Type Description
    System.Boolean

    true if ; otherwise, false.

    Remarks

    Use this property to enables or disables the visibility of the Latitude and Longitude values on the top right of the SfMap

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                syncMap.Layers.Add(layer);
                syncMap.ShowCoords = false;
    
            }
        }
    
    }

    ShowNavigationControl

    Enables or disables NavigationControl

    Declaration
    public bool ShowNavigationControl { get; set; }
    Property Value
    Type
    System.Boolean

    ZoomFactor

    Gets / ses the value of zooming factor

    Declaration
    public double ZoomFactor { get; set; }
    Property Value
    Type
    System.Double

    ZoomInCommand

    Gets the command for Zoom in the map.

    Declaration
    public ICommand ZoomInCommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    Type :System.Windows.Input.ICommand

    Remarks

    Use this command to zoom in the map.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                Button cmdButton = new Button();
                cmdButton.Command = syncMap.ZoomInCommand;
                syncMap.Layers.Add(layer);
            }
        }    
    }

    ZoomLevel

    Gets or sets the ZoomLevel for the map.Based the ZoomLevel value the map will be zoomed.

    Declaration
    public int ZoomLevel { get; set; }
    Property Value
    Type Description
    System.Int32

    Type :System.Int32

    The default value is 1

    Remarks

    Use this property to zoom in or zoom out the map. If the ZoomLavel is increased then map will be zoomed in.If value is decreases the map will be zoomed out.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();           
                SfMap syncMap = new SfMap();
                syncMap.ZoomLevel = 3;
                ShapeFileLayer layer = new ShapeFileLayer();          
                layer.Uri = "MapApp.world1.shp";          
                syncMap.Layers.Add(layer);            
            }
        }
    
    }

    ZoomOutCommand

    Gets the Command for zoom out the map.

    Declaration
    public ICommand ZoomOutCommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    Type :System.Windows.Input.ICommand

    Remarks

    Use this command to zoom out the map.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                Button cmdButton = new Button();
                cmdButton.Command = syncMap.ZoomOutCommand;
                syncMap.Layers.Add(layer);
            }
        }    
    }

    ZoomResetCommand

    Gets the command for reset the zoom of the map.

    Declaration
    public ICommand ZoomResetCommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    Type :System.Windows.Input.ICommand

    Remarks

    Use this command to reset the zoom of the map.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                Button cmdButton = new Button();
                cmdButton.Command = syncMap.ZoomResetCommand;
                syncMap.Layers.Add(layer);
            }
        }    
    }

    Methods

    Dispose()

    Dispose method invoked while unloading map control.

    Declaration
    public void Dispose()

    OnApplyTemplate()

    Defines OnApplyTemplate

    Declaration
    public override void OnApplyTemplate()

    OnKeyDown(KeyEventArgs)

    Declaration
    protected override void OnKeyDown(KeyEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.KeyEventArgs e

    OnKeyUp(KeyEventArgs)

    Declaration
    protected override void OnKeyUp(KeyEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.KeyEventArgs e

    OnManipulationCompleted(ManipulationCompletedEventArgs)

    Declaration
    protected override void OnManipulationCompleted(ManipulationCompletedEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.ManipulationCompletedEventArgs e

    OnManipulationDelta(ManipulationDeltaEventArgs)

    Declaration
    protected override void OnManipulationDelta(ManipulationDeltaEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.ManipulationDeltaEventArgs e

    OnManipulationStarted(ManipulationStartedEventArgs)

    Declaration
    protected override void OnManipulationStarted(ManipulationStartedEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.ManipulationStartedEventArgs e

    OnMouseLeave(MouseEventArgs)

    Declaration
    protected override void OnMouseLeave(MouseEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.MouseEventArgs e

    OnMouseLeftButtonDown(MouseButtonEventArgs)

    Declaration
    protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.MouseButtonEventArgs e

    OnMouseLeftButtonUp(MouseButtonEventArgs)

    Declaration
    protected override void OnMouseLeftButtonUp(MouseButtonEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.MouseButtonEventArgs e

    OnMouseMove(MouseEventArgs)

    Declaration
    protected override void OnMouseMove(MouseEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.MouseEventArgs e

    OnMouseWheel(MouseWheelEventArgs)

    Declaration
    protected override void OnMouseWheel(MouseWheelEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.MouseWheelEventArgs e

    OnScaleChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Occurs when the value of the NavigationControlScale property changes.

    Declaration
    public static void OnScaleChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    Parameters
    Type Name Description
    System.Windows.DependencyObject d
    System.Windows.DependencyPropertyChangedEventArgs e

    Pan(Double, Double)

    Method gets called to pan the map.

    Declaration
    public void Pan(double panx, double pany)
    Parameters
    Type Name Description
    System.Double panx

    The pan x value.

    System.Double pany

    The pan y value.

    Zoom(Double)

    Zoom the map with given zoom value.

    Declaration
    public void Zoom(double zoomValue)
    Parameters
    Type Name Description
    System.Double zoomValue

    Scale value of the map.

    Remarks

    Use this method to zoom in or zoom out the map based on the zoomValue parameter. zoomValue is the scale value of the zoom feature.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";            
                syncMap.Layers.Add(layer);
                syncMap.Zoom(2);
    
            }
        }
    
    }

    Events

    MapToolTipOpening

    Occurs when any tooltip on the SfMap control is opened.

    Declaration
    public event EventHandler<ToolTipOpeningEventArgs> MapToolTipOpening
    Event Type
    Type
    System.EventHandler<ToolTipOpeningEventArgs>

    Panned

    Occurs after panned the map.

    Declaration
    public event PanEventHandler Panned
    Event Type
    Type
    PanEventHandler
    Remarks

    Panned event will be triggered after panned the map. Use this event handler to do any operation after the map was panned.The event argument contains the Latitude, Longitude values and and PanningDirection.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                syncMap.Layers.Add(layer);
                syncMap.Panned += syncMap_Panned;
            }
    
            void syncMap_Panned(object sender, PanEventArgs args)
            {
                var latitude = args.Latitude;
                var longitude = args.Longitude;
                var direction = args.PanningDirection;
            }
    
        }
    
    }

    Panning

    Occurs while panning the map.

    Declaration
    public event PanEventHandler Panning
    Event Type
    Type
    PanEventHandler
    Remarks

    Panned event will be triggered while panning the map. Use this event handler to do any operation while the map is panning.The event argument contains the Latitude, Longitude values and and PanningDirection.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";
                syncMap.Layers.Add(layer);
                syncMap.Panning += syncMap_Panning;
    
            }
    
            void syncMap_Panning(object sender, PanEventArgs args)
            {
                var latitude = args.Latitude;
                var longitude = args.Longitude;
                var direction = args.PanningDirection;
            }       
        }
    
    }

    ZoomedIn

    Occurs when zooming the map.

    Declaration
    public event ZoomEventHandler ZoomedIn
    Event Type
    Type
    ZoomEventHandler
    Remarks

    ZoomedIn event will be triggered when zooming in the map. Use this event handler to do any operation when zooming the map.The event argument contains the Latitude, Longitude values and ZoomLevel.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";            
                syncMap.Layers.Add(layer);
                syncMap.ZoomedIn += syncMap_ZoomedIn;
            }
    
            void syncMap_ZoomedIn(object sender, ZoomEventArgs args)
            {
                var latitude = args.Latitude;
                var longitude = args.Longitude;
                var zoomlevel = args.ZoomLevel;
            }
        }
    
    }

    ZoomedOut

    Occurs when zoomed out the map.

    Declaration
    public event ZoomEventHandler ZoomedOut
    Event Type
    Type
    ZoomEventHandler
    Remarks

    ZoomedOut event will be triggered when zooming out the map. Use this event handler to do any operation when zooming out the map.The event argument contains the Latitude, Longitude values and ZoomLevel.

    Examples
    using Syncfusion.UI.Xaml.Maps;
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    
    namespace MapApp
    {
        public sealed partial class MainPage : Page
        {
            public MainPage()
            {
                this.InitializeComponent();
                SfMap syncMap = new SfMap();
                ShapeFileLayer layer = new ShapeFileLayer();
                layer.Uri = "MapApp.world1.shp";            
                syncMap.Layers.Add(layer);
                syncMap.ZoomedOut += syncMap_ZoomedOut;
            }
    
            void syncMap_ZoomedOut(object sender, ZoomEventArgs args)
            {
                var latitude = args.Latitude;
                var longitude = args.Longitude;
                var zoomlevel = args.ZoomLevel;
            }
    
        }
    
    }

    Implements

    System.IDisposable
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved