Show / Hide Table of Contents

Class MapView

A user interface control that displays two-dimensional (2D) geographic content defined by a Map.

Inheritance
System.Object
GeoView
MapView
Implements
Control
System.ComponentModel.INotifyPropertyChanged
GeoView.OnLostFocus(RoutedEventArgs)
GeoView.DrawStatusChanged
GeoView.LayerViewStateChanged
GeoView.SpatialReferenceChanged
GeoView.ViewpointChanged
GeoView.ShowCalloutForGeoElement(GeoElement, Windows.Foundation.Point, CalloutDefinition)
GeoView.ShowCalloutAt(MapPoint, CalloutDefinition)
GeoView.ShowCalloutAt(MapPoint, UIElement, Windows.Foundation.Point)
GeoView.DismissCallout()
GeoView.IsCalloutVisible
GeoView.ExportImageAsync()
GeoView.GraphicsOverlays
GeoView.GraphicsOverlaysProperty
GeoView.GetCurrentViewpoint(ViewpointType)
GeoView.SetViewpoint(Viewpoint)
GeoView.SetViewpointAsync(Viewpoint)
GeoView.SetViewpointAsync(Viewpoint, TimeSpan)
GeoView.SetBookmarkAsync(Bookmark)
GeoView.GetLayerViewState(Layer)
GeoView.IdentifyGraphicsOverlayAsync(GraphicsOverlay, Point, Double, Boolean)
GeoView.IdentifyGraphicsOverlayAsync(GraphicsOverlay, Point, Double, Boolean, Int64)
GeoView.IdentifyGraphicsOverlaysAsync(Point, Double, Boolean)
GeoView.IdentifyGraphicsOverlaysAsync(Point, Double, Boolean, Int64)
GeoView.IdentifyLayerAsync(Layer, Point, Double, Boolean)
GeoView.IdentifyLayerAsync(Layer, Point, Double, Boolean, CancellationToken)
GeoView.IdentifyLayerAsync(Layer, Point, Double, Boolean, Int64)
GeoView.IdentifyLayerAsync(Layer, Point, Double, Boolean, Int64, CancellationToken)
GeoView.IdentifyLayersAsync(Point, Double, Boolean)
GeoView.IdentifyLayersAsync(Point, Double, Boolean, CancellationToken)
GeoView.IdentifyLayersAsync(Point, Double, Boolean, Int64)
GeoView.IdentifyLayersAsync(Point, Double, Boolean, Int64, CancellationToken)
GeoView.GeoViewTapped
GeoView.GeoViewDoubleTapped
GeoView.GeoViewHolding
GeoView.INotifyPropertyChanged.PropertyChanged
GeoView.IsAttributionTextVisible
GeoView.AttributionText
GeoView.IsAttributionTextVisibleProperty
GeoView.SpatialReference
GeoView.IsWrapAroundEnabled
GeoView.IsNavigating
GeoView.NavigationCompleted
GeoView.DrawStatus
GeoView.ViewInsets
GeoView.ViewInsetsProperty
GeoView.TimeExtent
GeoView.TimeExtentProperty
GeoView.Overlays
GeoView.OverlaysProperty
GeoView.GetViewOverlayAnchor(FrameworkElement)
GeoView.SetViewOverlayAnchor(FrameworkElement, MapPoint)
GeoView.ViewOverlayAnchorProperty
GeoView.SelectionProperties
GeoView.SelectionPropertiesProperty
GeoView.Labeling
GeoView.LabelingProperty
GeoView.Grid
GeoView.GridProperty
GeoView.ImageOverlays
GeoView.ImageOverlaysProperty
Namespace: Esri.ArcGISRuntime.UI.Controls
Assembly: Esri.ArcGISRuntime.WinUI.dll
Syntax
public class MapView : GeoView, INotifyPropertyChanged
Remarks

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

SketchEditorProperty

Identifies the SketchEditor 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.

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.

IdentifyGeometryEditorAsync(Point, Double)

Identifies all the elements in the GeometryEditor, at the given screen point.

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

TargetVersions
.NET Windows100.13 - 200.8
In This Article
Back to top Copyright © 2022 Esri.