Class MapView
A user interface control that displays two-dimensional (2D) geographic content defined by a Map.
Implements
Namespace: Esri.ArcGISRuntime.UI.Controls
Assembly: Esri.ArcGISRuntime.WinUI.dll
Syntax
[TemplatePart(Name = "ZoomBox", Type = typeof(FrameworkElement))]
[ContentProperty(Name = "Map")]
public class MapView : GeoView, IEquatable<DependencyObject>, IAnimationObject, IVisualElement, IVisualElement2, IEquatable<UIElement>, IEquatable<FrameworkElement>, ICustomQueryInterface, IWinRTObject, IDynamicInterfaceCastable, IEquatable<Control>, INotifyPropertyChangedRemarks
The MapView is a container that holds a Map. A Map holds a collection of operational layers and Basemap. Layers are visual representations of geographic information and come in many forms. The types of layers that are displayed in a MapView are two dimensional in nature; meaning they are displayed in X/Y (a.k.a. Latitude/Longitude) coordinate space.
There is only one Map per MapView and it is set by the Map Property. Multiple Map objects can be created and swapped out dynamically as the application is running in the MapView.
To display a Map, add a MapView control to your app and assign the map to it. This loads the map, its basemap and collection of operational layers, and displays their content on screen.
User interactions such as pan, zoom, rotate, and identify or selection are supported in the MapView using touch, mouse, keyboard, or pen/pencil. If required, you can override keys, clicks, and gestures to provide a specific user experience.
The visible area of the MapView is represented by the Viewpoint.
You can programmatically set the visible area by specifying a viewpoint. For example, SetViewpointGeometryAsync(Geometry) sets the visible area to the extent of a provided geometry, and SetViewpointGeometryAsync(Geometry, Double) zooms to a given scale, centered at the given point. Any geometries passed to these methods are automatically projected to match the SpatialReference of the map view's Map, if required.
To determine the current visible area or the center point and scale of a MapView, call GetCurrentViewpoint(ViewpointType). Call IsNavigating to ensure that any user-initiated or programmatic navigation is complete before getting the current Viewpoint.
In an MVC architecture, this class represents the View tier. The Model tier is represented by the Map object which provides a collection of operational layers and a Basemap. A Layer provides a visual representation of geographic information and comes in many forms. The types of layers that are displayed in a MapView are two-dimensional in nature; meaning they are displayed in X/Y coordinate space.
Constructors
| Name | Description |
|---|---|
| MapView() | Initializes a new instance of the MapView class. |
Fields
| Name | Description |
|---|---|
| BackgroundGridProperty | Identifies the BackgroundGrid Dependency Property |
| GridProperty | Identifies the Grid Dependency Property |
| InteractionOptionsProperty | Identifies the InteractionOptions Dependency Property |
| LocationDisplayProperty | Identifies the LocationDisplay Dependency Property |
| MapProperty | Identifies the Map dependency property |
| SketchEditorProperty | Identifies the SketchEditor Dependency Property |
Properties
| Name | Description |
|---|---|
| BackgroundGrid | Gets or sets the background grid that a Map is displayed on top of. |
| Grid | Gets or sets a coordinate system grid to display on top of the MapView. |
| InteractionOptions | Gets or sets a set of properties that control user interaction with the MapView. |
| LocationDisplay | Gets the location display that manages and renders the device's current location on a MapView using a data source, such as a GPS sensor. |
| Map | Gets or sets the map that the MapView is displaying. |
| MapRotation | Gets the rotation angle of the Map in degrees from its north-south direction. |
| MapScale | Gets the scale of the MapView. |
| SketchEditor | Gets or sets the sketch editor used for drawing and editing on the map. |
| UnitsPerPixel | Gets the size of each device-independent pixel (DIP) in map units. |
| VisibleArea | Gets the view's visible area. |
| WrapAroundMode | Gets or sets whether continuous panning across the international date line is enabled. |
Methods
| Name | Description |
|---|---|
| CancelSetViewpointOperations() | Cancels any pending or currently running SetViewpointAsync operations. |
| LocationToScreen(MapPoint) | Converts a location in map coordinates to a screen coordinate relative to the upper-left corner of the map. |
| OnApplyTemplate() | Invoked whenever application code or internal processes (such as a rebuilding layout pass) call ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in your app. Override this method to influence the default post-template logic of a class. |
| OnCreateAutomationPeer() | Returns a class-specific AutomationPeer implementation for the Microsoft UI Automation infrastructure. |
| ScreenToLocation(Point) | Converts screen coordinates relative to the upper-left corner of the map view to a location in map coordinates. |
| SetViewpointAsync(Viewpoint, TimeSpan, AnimationCurve) | Animates the display to the new viewpoint using the provided animation curve. The AnimationCurve defines the animation easing function. |
| SetViewpointCenterAsync(MapPoint) | Centers the map view at the provided center point. |
| SetViewpointCenterAsync(MapPoint, Double) | Centers the map view at the provided center point and zooms to the given scale. |
| SetViewpointCenterAsync(Double, Double) | Centers the view on the provided point. |
| SetViewpointCenterAsync(Double, Double, Double) | Centers the view on the provided point and zooms to the provided scale. |
| SetViewpointGeometryAsync(Geometry) | Zooms and pans the map view to the extent of the provided geometry. |
| SetViewpointGeometryAsync(Geometry, Double) | Zooms and pans the map view to the extent of the provided geometry with additional padding. |
| SetViewpointRotationAsync(Double) | Sets the rotatation of the map view to the provided angle. |
| SetViewpointScaleAsync(Double) | Zooms the map view to the provided scale around its current center point. |
Applies to
| Target | Versions |
|---|---|
| .NET 6.0 Windows | 100.13 - 200.1 |