Skip to main content

DevExpress v25.1 Update — Your Feedback Matters

Our What's New in v25.1 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

MapPushpin Class

The class used to draw a pushpin on a map.

Namespace: DevExpress.Xpf.Map

Assembly: DevExpress.Xpf.Map.v25.1.dll

NuGet Package: DevExpress.Wpf.Map

#Declaration

public class MapPushpin :
    MapItem,
    IWeakEventListener,
    ISupportCoordLocation,
    IPointCore,
    IClusterable,
    IClusterItemCore,
    IClusterItem

The following members return MapPushpin objects:

#Remarks

A pushpin is a pointer that marks a geographical point on a map.

A typical map pushpin is shown in the image below.

Pushpin_Text

An instance of a map pushpin is represented by the MapPushpin object that is descendant of a VectorLayer object.

Use the MapPushpin.Location property to specify the pushpin position on a map.

In addition, you can change the pushpin state (MapPushpin.State), specify its text (MapPushpin.Text) and other appearance settings (MapPushpin.TraceDepth, MapPushpin.TraceStroke).

To learn more on pushpins, see the Vector Items topic.

#Example

This example illustrates how to provide animation for a map pushpin.

To do this, it is necessary to create a PushpinLocationAnimation object and assign it to the MapPushpin.LocationChangedAnimation property. After that, it becomes possible to customize the animation duration (PushpinLocationAnimation.Duration) and easing function (PushpinLocationAnimation.EasingFunction).

In addition, you can change the pushpin state after its location animation is complete via the PushpinLocationAnimation.Completed event. In this example, this event is used to change the pushpin location randomly each time the bouncing animation effect is complete.

<Window x:Class="LocationAnimation.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:sys="clr-namespace:System;assembly=mscorlib"
        xmlns:dxm="http://schemas.devexpress.com/winfx/2008/xaml/map"
        Title="MainWindow" Height="350" Width="525" >    
    <Grid>
        <dxm:MapControl>
            <dxm:ImageTilesLayer>
                <dxm:ImageTilesLayer.DataProvider>
                    <dxm:OpenStreetMapDataProvider/>
                </dxm:ImageTilesLayer.DataProvider>
            </dxm:ImageTilesLayer>
            <dxm:VectorLayer>
                <dxm:MapItemStorage>
                    <dxm:MapPushpin x:Name="pushpin" TraceDepth="30" TraceStroke="Red" >
                        <dxm:MapPushpin.LocationChangedAnimation>
                            <dxm:PushpinLocationAnimation  Duration="00:00:02"  Completed="PushpinLocationAnimation_Completed" >
                                <dxm:PushpinLocationAnimation.EasingFunction>
                                    <BounceEase/>
                                </dxm:PushpinLocationAnimation.EasingFunction>
                            </dxm:PushpinLocationAnimation>
                        </dxm:MapPushpin.LocationChangedAnimation>
                    </dxm:MapPushpin>
                <dxm:MapItemStorage>
            </dxm:VectorLayer>
        </dxm:MapControl>
    </Grid>
</Window>
See Also