MapControl.ZoomLevel Property

Gets or sets the current zoom level of a Map Control.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v19.2.dll

Declaration

C#

[DefaultValue(1)]
public double ZoomLevel { get; set; }

VB.NET

<DefaultValue(1)>
Public Property ZoomLevel As Double

Property Value

Type	Default	Description
Double	1	A double value specifying the current zoom level.

Example

This example describes how to add a MapControl to a Windows Forms application and connect the control to the BingMapDataProvider data provider at runtime.

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

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

   

4. Select the following assemblies in the Extensions tab:

   • DevExpress.XtraMap
   • DevExpress.Map.Core
   • DevExpress.Data
   • DevExpress.Utils

   

   Click OK.

5. Handle the Form.Load event as follows:

   C#

   using System;
   using System.Windows.Forms;
   using DevExpress.XtraMap;
   
   namespace MapControlRuntimeSample {
       public partial class Form1 : Form {
           public Form1() {
               InitializeComponent();
           }
           private void OnFormLoad(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.
               BingMapDataProvider provider = new BingMapDataProvider();
               provider.BingKey = "Your Bing Maps key";
               layer.DataProvider = provider;
   
               // Specify the map zoom level and center point. 
               map.ZoomLevel = 3;
               map.CenterPoint = new GeoPoint(40, -100);
   
               // Add the map control to the window.
               this.Controls.Add(map);
           }
       }
   }
   

   VB.NET

   Imports System
   Imports System.Windows.Forms
   Imports DevExpress.XtraMap
   
   Namespace MapControlRuntimeSample
       Partial Public Class Form1
           Inherits Form
   
           Public Sub New()
               InitializeComponent()
           End Sub
           Private Sub OnFormLoad(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
               ' 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 BingMapDataProvider()
               provider.BingKey = "Your Bing Maps key here"
               layer.DataProvider = provider
   
               ' Specify the map zoom level and center point. 
               map.ZoomLevel = 3
               map.CenterPoint = New GeoPoint(40, -100)
   
               ' Add the map control to the window.
               Me.Controls.Add(map)
           End Sub
       End Class
   End Namespace
   

   The example above uses the following entities:

   Class	Description
   MapControl	Displays raster and vector maps. Supports both popular map services (Bing Maps and OpenStreetMap) and custom map data servers inside your corporate network. See Map Control.
   ImageLayer	Displays map images obtained from map image data providers.
   BingMapDataProvider	The class that loads map images from the Bing Maps data provider.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ZoomLevel property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

vote-app-t445500/CS/VoteApp/Map.cs#L387

MapViewData SaveMapView(MapControl map) {
    return new VoteApp.MapViewData() { CenterPoint = map.CenterPoint, Zoom = map.ZoomLevel };
}

vote-applications-t446758/CS/VoteApp/Map.cs#L386

MapViewData SaveMapView(MapControl map) {
    return new VoteApp.MapViewData() { CenterPoint = map.CenterPoint, Zoom = map.ZoomLevel };
}

how-to-colorize-map-contours-loaded-from-shapefiles-using-the-graph-colorizer-e4723/CS/MapGraphColorizer/Form1.cs#L20

// Specify the map's initial view.
map.ZoomLevel = 2;
map.CenterPoint = new GeoPoint(38, -100);

how-to-calculate-a-distance-and-travel-time-between-waypoints-on-the-map-t239498/CS/TravelTimeDistance/Form1.cs#L29

mapControl1.ZoomLevel = 12.0;
mapControl1.CenterPoint = new GeoPoint(51.5, -0.1);

how-to-get-additional-search-results-using-the-bing-map-search-service-e5066/CS/GetSearchLocationAdditionalInfo/Form1.cs#L43

    map.CenterPoint = geoPoint;
    map.ZoomLevel = 11;
}

VB.NET

how-to-colorize-map-contours-loaded-from-shapefiles-using-the-graph-colorizer-e4723/VB/MapGraphColorizer/Form1.vb#L22

' Specify the map's initial view.
map.ZoomLevel = 2
map.CenterPoint = New GeoPoint(38, -100)

how-to-calculate-a-distance-and-travel-time-between-waypoints-on-the-map-t239498/VB/TravelTimeDistance/Form1.vb#L42

mapControl1.ZoomLevel = 12.0
mapControl1.CenterPoint = New GeoPoint(51.5, -0.1)

how-to-get-additional-search-results-using-the-bing-map-search-service-e5066/VB/GetSearchLocationAdditionalInfo/Form1.vb#L45

    map.CenterPoint = geoPoint
    map.ZoomLevel = 11
End Sub

how-to-programmatically-create-a-map-control-and-connect-it-to-the-openstreet-web-service-e4665/VB/CreateMap/Form1.vb#L29

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

how-to-perform-the-search-operation-for-multiple-locations-t546604/VB/GetSearchLocationAdditionalInfo/Form1.vb#L77

    map.CenterPoint = geoPoint
    map.ZoomLevel = 15
End Sub