[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
   [Collapse]Visual Elements
     Map Area
     Mini Map
     Navigation Panel
     Search Panel
     Map Overlay
     Map Overlay Items
     Vector Items
   [Expand]End-User Features
   [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)

Map Overlay Items

The map overlay items are containers that allow you to provide a content that should be displayed over the map using Map Overlays.

This topic consists of the following sections.

Expanded Overview

There are two types of map items.

Expanded Overlay Item Layout

For overlay items of all types their layout can be customized. At the first, overlay items can be arranged automatically. For this, specify the MapOverlayItemBase.Alignment property, which allows specifying the alignment of items. If several items have the same alignment, the MapOverlayItemBase.JoiningOrientation property configures how to stack items. The following table demonstrates this property in action.


The MapOverlayItemBase.JoiningOrientation specifies how the item will be joined to the previously arranged items. In this way, the property shoud be specified to the stacking object.

The Property Value The Resulting Image
JoiningOrientation = Horizontal
JoiningOrientation = Vertical

If it is required to locate an item to the specific position with specific size manually, configure the MapOverlayItemBase.Location and MapOverlayItemBase.Size properties.

Moreover, the MapOverlayItemBase.Padding and MapOverlay.Margin properties allows you can specify required values of margin and padding.


If the item size is specified manually, then the total size is calculated as size plus padding. In the same way, if location is specified manually, the actual location of an item is dependent on the location and margin.

Also, the location of an item is dependent on the alignment. For example, if MapOverlayItemBase.Alignment is set to BottomRight, then the MapOverlayItemBase.Location property will specify the distance from the bottom right angle of the overlay to the bottom right angle of the item.

Expanded Overlay Item Appearance

To customize item appearance, use the MapOverlayItemBase.BackgroundStyle property. In addition it is possible to specify the background style when an item is hit tested. To do this, modify the MapOverlayItemBase.HotTrackedStyle property.

The following image demonstrates hot tracked style applied to the text item.

To hide or show the item, specify the reqired value to the MapOverlayItemBase.Visible property.

Expanded See Also

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