Back to Devexpress

MapControl.MapItemClick Event

windowsforms-devexpress-dot-xtramap-dot-mapcontrol-b75040da.md

latest4.0 KB
Original Source

MapControl.MapItemClick Event

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

Namespace : DevExpress.XtraMap

Assembly : DevExpress.XtraMap.v25.2.dll

NuGet Package : DevExpress.Win.Map

Declaration

csharp
public event MapItemClickEventHandler MapItemClick
vb
Public Event MapItemClick As MapItemClickEventHandler

Event Data

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

PropertyDescription
HandledGets or sets a value specifying whether an event has been handled.
ItemGets a map item to be represented in the map control. Inherited from MapItemEventArgs.
MouseArgsReturns 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:

csharp
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
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

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.

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

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

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

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

See Also

MapControl Class

MapControl Members

DevExpress.XtraMap Namespace