Skip to main content

Map Overlay Items

  • 3 minutes to read

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.


There are two types of map items.

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_Horizontal
JoiningOrientation = Vertical 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.

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.

See Also