How to: Show Additional Information Over the Map

• Nov 13, 2018
• 2 minutes to read

To show additional information over the map, do the following.

• Create and customize a MapOverlay object. For example, specify its MapOverlay.Margin and MapOverlay.Padding.
• Then, add a MapOverlayItemBase class descendant object to the MapOverlay.Items collection and configure it. For instance, specify the displayed image of MapOverlayImageItem using the MapOverlayImageItem.ImageUri, MapOverlayImageItem.Image or MapOverlayImageItem.ImageIndex property; or a text of MapOverlayTextItem using the MapOverlayTextItem.Text property.
• Finally, add the overlay to the MapControl.Overlays collection.

Note

To learn more about overlays and overlay items, refer to the Map Overlay and Map Overlay Items topics.

Form1.cs

using DevExpress.XtraMap;
using System;
using System.Drawing;
using System.Windows.Forms;
//...
private void Form1_Load(object sender, EventArgs e) {
    MapOverlay overlayWithText = new MapOverlay {
        Alignment = ContentAlignment.BottomRight,
        JoiningOrientation = Orientation.Vertical,
        Margin = new Padding(0, 4, 8, 8),
        Padding = new Padding(7)
    };
    overlayWithText.Items.Add(new MapOverlayTextItem {
        Text = "Copyright © 2015. Microsoft and its suppliers. All rights reserved."
    });
    map.Overlays.Add(overlayWithText);

    Uri baseUri = new Uri(System.Reflection.Assembly.GetEntryAssembly().Location);
    MapOverlay overlayWithImage = new MapOverlay {
        Alignment = ContentAlignment.BottomRight,
        JoiningOrientation = Orientation.Vertical,
        Margin = new Padding(0, 0, 8, 4),
        Padding = new Padding(0),
    };
    overlayWithImage.Items.Add(new MapOverlayImageItem { ImageUri = new Uri(baseUri, "..\\..\\Images\\BingLogo.png") });
    map.Overlays.Add(overlayWithImage);
}

Form1.vb

Imports DevExpress.XtraMap
Imports System
Imports System.Drawing
Imports System.Windows.Forms
'...
Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
    Dim overlayWithText As MapOverlay = New MapOverlay With {.Alignment = ContentAlignment.BottomRight, .JoiningOrientation = Orientation.Vertical, .Margin = New Padding(0, 4, 8, 8), .Padding = New Padding(7)}
    overlayWithText.Items.Add(New MapOverlayTextItem With {.Text = "Copyright © 2015. Microsoft and its suppliers. All rights reserved."})
    map.Overlays.Add(overlayWithText)

    Dim baseUri As New Uri(System.Reflection.Assembly.GetEntryAssembly().Location)
    Dim overlayWithImage As MapOverlay = New MapOverlay With {.Alignment = ContentAlignment.BottomRight, .JoiningOrientation = Orientation.Vertical, .Margin = New Padding(0, 0, 8, 4), .Padding = New Padding(0)}
    overlayWithImage.Items.Add(New MapOverlayImageItem With {.ImageUri = New Uri(baseUri, "..\..\Images\BingLogo.png")})
    map.Overlays.Add(overlayWithImage)
End Sub