MapControl.MapItemClick Event

Fires when a map item of the Map Control is clicked.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

public event MapItemClickEventHandler MapItemClick

VB.NET

Public Event MapItemClick As MapItemClickEventHandler

Event Data

The MapItemClick event's data class is MapItemClickEventArgs. The following properties provide information specific to this event:

Property	Description
Handled	Gets or sets a value specifying whether an event has been handled.
Item	Gets a map item to be represented in the map control. Inherited from MapItemEventArgs.
MouseArgs	Returns data for the MouseUp, MouseDown, and MouseMove events.

Remarks

The MapItemClick event occurs when a map item is clicked on a map.

Example

The following code invokes a PopupMenu when a user right-clicks a map path:

C#

mapControl1.MapItemClick += OnMapItemClick;
//...    
private void OnMapItemClick(object sender, MapItemClickEventArgs e) {
   if (e.MouseArgs.Button == MouseButtons.Right && e.Item is MapPath) {
        popupMenu1.ShowPopup(Cursor.Position);
   }
}

VB.NET

mapControl1.MapItemClick += OnMapItemClick
'...
Private Sub OnMapItemClick(ByVal sender As Object, ByVal e As MapItemClickEventArgs)
    If e.MouseArgs.Button Is MouseButtons.Right AndAlso TypeOf e.Item Is MapPath Then
        popupMenu1.ShowPopup(Cursor.Position)
    End If
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the MapItemClick event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-dashboard-custom-items-extension/CS/CustomItemExtension/CustomItems/WaypointMap/WaypointMapItemControlProvider.cs#L33

map = new MapControl();
map.MapItemClick += MapItemClickHandler;
map.SelectionChanged += Map_SelectionChanged;

VB.NET

winforms-dashboard-custom-items-extension/VB/CustomItemExtension/CustomItems/WaypointMap/WaypointMapItemControlProvider.vb#L43

map = New MapControl()
AddHandler map.MapItemClick, AddressOf MapItemClickHandler
AddHandler map.SelectionChanged, AddressOf Map_SelectionChanged