How to: Create a Map Control via Code

• Nov 13, 2018
• 2 minutes to read

This example describes how to programmatically add a MapControl in a Windows Forms application and connect this control to the OpenStreetMap data provider.

• Run MS Visual Studio.
• Create a new Windows Forms Application project or open an existing one.

• Open the Solution Explorer, right-click References and choose Add Reference… to add the Map Control Library.

  

• In the Extensions tab, select the DevExpress.XtraMap, DevExpress.Map.Core, DevExpress.Data and DevExpress.Utils assemblies and click OK.

  

• Write the following (or similar) code:

C#

using System;
using System.Windows.Forms;
using DevExpress.XtraMap;

namespace CreateMap {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {
            // Create a map control.
            MapControl map = new MapControl();

            // Specify the map position on the form.           
            map.Dock = DockStyle.Fill;

            // Create a layer.
            ImageLayer layer = new ImageLayer();
            map.Layers.Add(layer);

            // Create a data provider.
            OpenStreetMapDataProvider provider = new OpenStreetMapDataProvider();
            layer.DataProvider = provider;

            // Specify the map zoom level and center point. 
            map.ZoomLevel = 2;
            map.CenterPoint = new GeoPoint(38, -100);

            // Add the map control to the window.
            this.Controls.Add(map);
        }
    }
}

VB.NET

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraMap

Namespace CreateMap 

    Partial Public Class Firm1
        Inherits Form
        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub Form1_Load(ByVal sender As Object, ByVal e As RoutedEventArgs)
            ' Create a map control.
            Dim map As New MapControl()

            ' Specify the map position on the form.
             map.Dock = DockStyle.Fill

            ' Create a layer.
            Dim layer As New ImageLayer()
            map.Layers.Add(layer)

            ' Create a data provider.
            Dim provider As New OpenStreetMapDataProvider()
            layer.DataProvider = provider

            ' Specify the map zoom level and center point. 
            map.ZoomLevel = 2
            map.CenterPoint As New GeoPoint(38, -100)

            ' Add the map control to the window.
            Me.Controls.Add(map)
        End Sub
    End Class
End Namespace

The MapControl has now been created and connected to the OpenStreetMap provider.

Run the application to see the result.