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
public class MapView : GeoView, 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.
It controls the area (extent) of the Map that is visible and supports user interactions such as pan and zoom. A map view also provides access to the underlying layer data in a map.
To display a Map, add a MapView control to your app and assign the map to it. This loads the map and its content, such as a Basemap and collection of operational layers, and displays this 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 (Viewpoint) of the MapView is defined by the visible extent the map. To determine the current visible area or the center point and scale of a MapView, call GetCurrentViewpoint(ViewpointType). Make sure that any user-initiated or programmatic navigation is complete before getting the current Viewpoint by calling IsNavigating.
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 SetViewpointCenterAsync(MapPoint) centers the map view at a given point. Any geometries passed to these methods are automatically projected to match the SpatialReference of the map view's Map, if required.
In an MVC architecture, the MapView represents the View tier. The Model tier is represented by the Map object which can provide a collection of operational layers and a Basemap. You can only set one Map per MapView, but you can swap the Map with another when the application is running. See the Map view discussion in the developer guide for more information.
Constructors
| Name | Description |
|---|---|
| MapView() | Initializes a new instance of the MapView class. |
Fields
| Name | Description |
|---|---|
| BackgroundGridProperty | Identifies the BackgroundGrid Dependency Property |
| GeometryEditorProperty | Identifies the GeometryEditor Dependency Property |
| InteractionOptionsProperty | Identifies the InteractionOptions Dependency Property |
| LocationDisplayProperty | Identifies the LocationDisplay Dependency Property |
| MapProperty | Identifies the Map dependency property |
Properties
| Name | Description |
|---|---|
| BackgroundGrid | Gets or sets the background grid that a Map is displayed on top of. |
| GeometryEditor | Gets or sets the editor that allows users to interactively create and edit geometries by interacting with the view. |
| 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. |
| 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() | |
| OnCreateAutomationPeer() | |
| 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 Windows | 100.13 - 200.6 |