This project has moved. For the latest updates, please go here.

Use of MapItem, MapItemControl and MapOverlay

Feb 13, 2015 at 11:06 AM
May sound stupid and I do not ask Clemens to write the documentation, is already so much what he does,but it would be possible for someone to write just two lines on the following items so that those who approach this wonderful control can fully understand the differences?
The items are:
MapItem
MapItemControl
MapOverlay

Thanks in advance
Coordinator
Feb 13, 2015 at 12:08 PM
Edited Feb 13, 2015 at 12:09 PM
Looking at the source code, you'll see that MapItemsControl is derived from ListBox, and MapItem is derived from ListBoxItem. The summary in MapItemsControl says
Manages a collection of selectable items on a Map. Uses MapItem as item container class.
The difference to a regular ListBox is that it (besides using MapItem instead of ListBoxItem as item container class) uses a MapPanel as its ItemsPanel, and that it sets the ZIndex of selected items to be higher than those of not selected items. As shown in the sample applications, you could write a Style for MapItem that sets the MapPanel.Location attached property, so that the item is placed at the respective location on the map.

A MapOverlay is just a derived MapPanel, that declares a lot of font and drawing related properties. It is meant to be used as base class for complex overlays, like e.g. the MapGraticule.
Feb 13, 2015 at 12:13 PM
Thank you Clemens.
MapOverlay can be considered as a MapLayer in Microsoft Bing Control?
Coordinator
Feb 13, 2015 at 1:38 PM
The Bing Maps MapLayer better compares to MapPanel.