Class MapControl

Inheritance
object
MarshalByRefObject
Component
Control
ScrollableControl
ContainerControl
UserControl
MapControl
Implements
Inherited Members
Namespace: Mapsui.UI.WindowsForms
Assembly: Mapsui.UI.WindowsForms.dll
Syntax
public class MapControl : UserControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IContainerControl, IMapControl, IDisposable, INotifyPropertyChanged

Constructors

| Edit this page View Source

MapControl()

Declaration
public MapControl()

Properties

| Edit this page View Source

Map

Map holding data for which is shown in this MapControl

Declaration
[Browsable(false)]
public Map Map { get; set; }
Property Value
Type Description
Map
| Edit this page View Source

MaxTapGestureMovement

The movement allowed between a touch down and touch up in a touch gestures in device independent pixels.

Declaration
public int MaxTapGestureMovement { get; set; }
Property Value
Type Description
int
| Edit this page View Source

UseFling

Use fling gesture to move the map. Default is true. Fling means that the map will continue to move for a short time after the user has lifted the finger.

Declaration
public bool UseFling { get; set; }
Property Value
Type Description
bool
| Edit this page View Source

UseGPU

Declaration
public static bool UseGPU { get; set; }
Property Value
Type Description
bool

Methods

| Edit this page View Source

Dispose(bool)

Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources.

Declaration
protected override void Dispose(bool disposing)
Parameters
Type Name Description
bool disposing

true to release both managed and unmanaged resources; false to release only unmanaged resources.
Overrides
| Edit this page View Source

ForceUpdate()

Force a update of control

Declaration
public void ForceUpdate()
Remarks

When this function is called, the control draws itself once

| Edit this page View Source

GetMapInfo(ScreenPosition, IEnumerable<ILayer>)

Check, if a feature at a given screen position is hit.

Declaration
public MapInfo GetMapInfo(ScreenPosition screenPosition, IEnumerable<ILayer> layers)
Parameters
Type Name Description
ScreenPosition screenPosition

Screen position to check for widgets and features.
IEnumerable<ILayer> layers

The layers to query.
Returns
Type Description
MapInfo
| Edit this page View Source

GetPixelDensity()

Returns the number of pixels per device independent unit

Declaration
public float? GetPixelDensity()
Returns
Type Description
float?
| Edit this page View Source

GetRemoteMapInfoAsync(ScreenPosition, Viewport, IEnumerable<ILayer>)

Declaration
protected Task<MapInfo> GetRemoteMapInfoAsync(ScreenPosition screenPosition, Viewport viewport, IEnumerable<ILayer> layers)
Parameters
Type Name Description
ScreenPosition screenPosition
Viewport viewport
IEnumerable<ILayer> layers
Returns
Type Description
Task<MapInfo>
| Edit this page View Source

GetScreenPosition(Point)

Declaration
public ScreenPosition GetScreenPosition(Point position)
Parameters
Type Name Description
Point position
Returns
Type Description
ScreenPosition
| Edit this page View Source

GetSnapshot(IEnumerable<ILayer>?, RenderFormat, int)

Create a snapshot form map as PNG image

Declaration
public byte[] GetSnapshot(IEnumerable<ILayer>? layers = null, RenderFormat renderFormat = RenderFormat.Png, int quality = 100)
Parameters
Type Name Description
IEnumerable<ILayer> layers

Layers that should be included in snapshot
RenderFormat renderFormat

render format
int quality

default quality is 90 is applicable for webp and jpg
Returns
Type Description
byte[]

Byte array with snapshot in png format. If there are any problems than returns null.
| Edit this page View Source

InvalidateCanvas()

Declaration
public void InvalidateCanvas()
| Edit this page View Source

OnMapInfo(MapInfoEventArgs)

Declaration
protected void OnMapInfo(MapInfoEventArgs mapInfoEventArgs)
Parameters
Type Name Description
MapInfoEventArgs mapInfoEventArgs
| Edit this page View Source

OnMapPointerMoved(ScreenPosition, MPoint, GestureType)

Declaration
protected virtual bool OnMapPointerMoved(ScreenPosition screenPosition, MPoint worldPosition, GestureType gestureType)
Parameters
Type Name Description
ScreenPosition screenPosition
MPoint worldPosition
GestureType gestureType
Returns
Type Description
bool
| Edit this page View Source

OnMapPointerPressed(ScreenPosition, MPoint)

Declaration
protected virtual bool OnMapPointerPressed(ScreenPosition screenPosition, MPoint worldPosition)
Parameters
Type Name Description
ScreenPosition screenPosition
MPoint worldPosition
Returns
Type Description
bool
| Edit this page View Source

OnMapPointerReleased(ScreenPosition, MPoint)

Declaration
protected virtual bool OnMapPointerReleased(ScreenPosition screenPosition, MPoint worldPosition)
Parameters
Type Name Description
ScreenPosition screenPosition
MPoint worldPosition
Returns
Type Description
bool
| Edit this page View Source

OnMapTapped(ScreenPosition, MPoint, GestureType)

Declaration
protected virtual bool OnMapTapped(ScreenPosition screenPosition, MPoint worldPosition, GestureType gestureType)
Parameters
Type Name Description
ScreenPosition screenPosition
MPoint worldPosition
GestureType gestureType
Returns
Type Description
bool
| Edit this page View Source

OnPropertyChanged(string)

Declaration
protected void OnPropertyChanged(string propertyName = "")
Parameters
Type Name Description
string propertyName
| Edit this page View Source

OpenInBrowser(string)

Declaration
public void OpenInBrowser(string url)
Parameters
Type Name Description
string url
| Edit this page View Source

Refresh(ChangeType)

Declaration
public void Refresh(ChangeType changeType = ChangeType.Discrete)
Parameters
Type Name Description
ChangeType changeType
| Edit this page View Source

RefreshData(ChangeType)

Refresh data of Map, but don't paint it

Declaration
public void RefreshData(ChangeType changeType = ChangeType.Discrete)
Parameters
Type Name Description
ChangeType changeType
| Edit this page View Source

RefreshGraphics()

Declaration
public void RefreshGraphics()
| Edit this page View Source

SetMapRenderer(IMapRenderer)

Declaration
public void SetMapRenderer(IMapRenderer mapRenderer)
Parameters
Type Name Description
IMapRenderer mapRenderer
| Edit this page View Source

Unsubscribe()

Unsubscribe from map events

Declaration
public void Unsubscribe()

Events

| Edit this page View Source

Info

Called whenever the map is clicked. The MapInfoEventArgs contain the features that were hit in the layers that have IsMapInfoLayer set to true.

Declaration
public event EventHandler<MapInfoEventArgs>? Info
Event Type
Type Description
EventHandler<MapInfoEventArgs>
Remarks

The Map.Tapped event is preferred over the Info event. This event is kept for backwards compatibility.

| Edit this page View Source

MapPointerMoved

Event that is triggered when on pointer move. Can be a drag or hover.

Declaration
public event EventHandler<MapEventArgs>? MapPointerMoved
Event Type
Type Description
EventHandler<MapEventArgs>
| Edit this page View Source

MapPointerPressed

Event that is triggered when on pointer down.

Declaration
public event EventHandler<MapEventArgs>? MapPointerPressed
Event Type
Type Description
EventHandler<MapEventArgs>
| Edit this page View Source

MapPointerReleased

Event that is triggered when on pointer up.

Declaration
public event EventHandler<MapEventArgs>? MapPointerReleased
Event Type
Type Description
EventHandler<MapEventArgs>
| Edit this page View Source

MapTapped

Event that is triggered when the map is tapped. Can be a single tap, double tap or long press.

Declaration
public event EventHandler<MapEventArgs>? MapTapped
Event Type
Type Description
EventHandler<MapEventArgs>
| Edit this page View Source

PropertyChanged

Called whenever a property is changed

Declaration
public event PropertyChangedEventHandler? PropertyChanged
Event Type
Type Description
PropertyChangedEventHandler

Implements

Extension Methods