[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Collapse]Map Control
   [Expand]Getting Started
   [Expand]Coordinate Systems
   [Expand]Map Image Data
   [Expand]GIS Data
   [Expand]Vector Data
   [Expand]Visual Elements
   [Collapse]End-User Features
     Select and Highlight Map Items
     Search Panel
     Map Editor
     Mini Map
     Printing and Exporting
   [Expand]Product Information
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


End users can navigate a map using the Map control's scrolling capabilities.

Expanded Overview

Scrolling is enabled in the Map Control by default. Set the MapControl.EnableScrolling property to false to disable scrolling.

Use the MiniMap.EnableScrolling property to manage scrolling on a mini-map. Refer to the Mini Map topic to learn more about mini-maps.

Expanded Circular Scrolling

The Map Control allows you to scroll a map horizontally infinitely. Use the GeoMapCoordinateSystem.CircularScrollingMode property to set the appropriate circular scrolling mode.

The following code shows how to allow end users to endlessly scroll an image tile and vector items' layers:

The table below lists classes and properties which the code uses:

Class or Property Description
MapControl.CoordinateSystem Specifies a map's coordinate system.
GeoMapCoordinateSystem The geographical coordinate system.
CircularScrollingMode Lists modes that specify the Circular Scrolling behavior.

Note the following points before using Circular Scrolling:

Note that, a map shape should fulfill the following condition to cross the 180th meridian: one or several points' longitudes should exceed the 180 (-180) limit:

The code above produces the following image:

Expanded How End Users Can Scroll a Map

An end user can scroll a map as follows:



Hold down the left mouse button and drag it

Move the mouse pointer while holding down the left mouse button. The mouse pointer changes from to when an end user holds down the left mouse button. The map is scrolled in the same direction as the mouse pointer's movement.

Use the arrows on the map navigation panel.

An end user can scroll a map in four directions by clicking the arrows on the map navigation panel. For example, use the right arrow in the navigation panel to scroll to the east.

Use the NavigationPanelOptions.ShowScrollButtons property to manage scroll buttons' visibility in the navigation panel.

Use the "Arrow" keys (Left, Up, Right or Down).

Press the Left arrow key to scroll the map west.

Press the Up arrow key to scroll the map north.

Press the Right arrow key to scroll the map east.

Press the Down arrow key to scroll the map south.

Use flick gestures on touchscreen devices.

An end user can scroll a map using flick gestures on a touchscreen device.

Is this topic helpful?​​​​​​​