MapControl MapControl MapControl Class

Definition

Represents a symbolic or photorealistic map of the Earth.

public : sealed class MapControl : Control, IMapControl, IMapControl2, IMapControl3, IMapControl4, IMapControl5
public sealed class MapControl : Control, IMapControl, IMapControl2, IMapControl3, IMapControl4, IMapControl5
Public NotInheritable Class MapControl Inherits Control Implements IMapControl, IMapControl2, IMapControl3, IMapControl4, IMapControl5
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl/>
- or -
<Maps:MapControl></Maps:MapControl>

Inheritance
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Constructors

MapControl() MapControl() MapControl()

Initializes a new instance of the MapControl class.

public : MapControl()
public MapControl()
Public Sub New()
See Also

Properties

AccessKey AccessKey AccessKey

Inherited from UIElement

AccessKeyProperty AccessKeyProperty AccessKeyProperty

Inherited from UIElement

AccessKeyScopeOwner AccessKeyScopeOwner AccessKeyScopeOwner

Inherited from UIElement

AccessKeyScopeOwnerProperty AccessKeyScopeOwnerProperty AccessKeyScopeOwnerProperty

Inherited from UIElement

ActualCamera ActualCamera ActualCamera

Gets the MapCamera settings that define the current position of the camera.

public : MapCamera ActualCamera { get; }
public MapCamera ActualCamera { get; }
Public ReadOnly Property ActualCamera As MapCamera
Value
MapCamera MapCamera MapCamera

The MapCamera settings that define the current position of the camera.

Remarks

During an animation of the map, the ActualCamera defines the current position of the map's camera and TargetCamera defines the final position of the camera.

The map's camera settings are updated whenever the view of the map is changed. For example, when updating the Center property or calling the TrySetSceneAsync method.

ActualHeight ActualHeight ActualHeight

Inherited from FrameworkElement

ActualHeightProperty ActualHeightProperty ActualHeightProperty

Inherited from FrameworkElement

ActualTheme ActualTheme ActualTheme

Inherited from FrameworkElement

ActualThemeProperty ActualThemeProperty ActualThemeProperty

Inherited from FrameworkElement

ActualWidth ActualWidth ActualWidth

Inherited from FrameworkElement

ActualWidthProperty ActualWidthProperty ActualWidthProperty

Inherited from FrameworkElement

AllowDrop AllowDrop AllowDrop

Inherited from UIElement

AllowDropProperty AllowDropProperty AllowDropProperty

Inherited from UIElement

AllowFocusOnInteraction AllowFocusOnInteraction AllowFocusOnInteraction

Inherited from FrameworkElement

AllowFocusOnInteractionProperty AllowFocusOnInteractionProperty AllowFocusOnInteractionProperty

Inherited from FrameworkElement

AllowFocusWhenDisabled AllowFocusWhenDisabled AllowFocusWhenDisabled

Inherited from FrameworkElement

AllowFocusWhenDisabledProperty AllowFocusWhenDisabledProperty AllowFocusWhenDisabledProperty

Inherited from FrameworkElement

Background Background Background

Inherited from Control

BackgroundProperty BackgroundProperty BackgroundProperty

Inherited from Control

BaseUri BaseUri BaseUri

Inherited from FrameworkElement

BorderBrush BorderBrush BorderBrush

Inherited from Control

BorderBrushProperty BorderBrushProperty BorderBrushProperty

Inherited from Control

BorderThickness BorderThickness BorderThickness

Inherited from Control

BorderThicknessProperty BorderThicknessProperty BorderThicknessProperty

Inherited from Control

BusinessLandmarksEnabled BusinessLandmarksEnabled BusinessLandmarksEnabled

This property is not implemented.

public : Platform::Boolean BusinessLandmarksEnabled { get; set; }
public bool BusinessLandmarksEnabled { get; set; }
Public ReadWrite Property BusinessLandmarksEnabled As bool
Value
Platform::Boolean bool bool

This property is not implemented.

Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

BusinessLandmarksEnabledProperty BusinessLandmarksEnabledProperty BusinessLandmarksEnabledProperty

This property is not implemented.

public : static DependencyProperty BusinessLandmarksEnabledProperty { get; }
public static DependencyProperty BusinessLandmarksEnabledProperty { get; }
Public Static ReadOnly Property BusinessLandmarksEnabledProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

This property is not implemented.

Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

BusinessLandmarksVisible BusinessLandmarksVisible BusinessLandmarksVisible

Gets or sets a value that indicates whether businesses are displayed on the map.

public : Platform::Boolean BusinessLandmarksVisible { get; set; }
public bool BusinessLandmarksVisible { get; set; }
Public ReadWrite Property BusinessLandmarksVisible As bool
Value
Platform::Boolean bool bool

true if businesses are displayed on the map; otherwise, false.

BusinessLandmarksVisibleProperty BusinessLandmarksVisibleProperty BusinessLandmarksVisibleProperty

Identifies the BusinessLandmarksVisible dependency property.

public : static DependencyProperty BusinessLandmarksVisibleProperty { get; }
public static DependencyProperty BusinessLandmarksVisibleProperty { get; }
Public Static ReadOnly Property BusinessLandmarksVisibleProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the BusinessLandmarksVisible dependency property.

CacheMode CacheMode CacheMode

Inherited from UIElement

CacheModeProperty CacheModeProperty CacheModeProperty

Inherited from UIElement

CanDrag CanDrag CanDrag

Inherited from UIElement

CanDragProperty CanDragProperty CanDragProperty

Inherited from UIElement

Center Center Center

Gets or sets the center of the map.

public : Geopoint Center { get; set; }
public Geopoint Center { get; set; }
Public ReadWrite Property Center As Geopoint
Value
Geopoint Geopoint Geopoint

The center of the map.

Remarks

Since a string can't be converted to a Geopoint, you can't specify a value for the Center property in XAML markup unless you use data binding.

See Also

CenterProperty CenterProperty CenterProperty

Identifies the Center dependency property.

public : static DependencyProperty CenterProperty { get; }
public static DependencyProperty CenterProperty { get; }
Public Static ReadOnly Property CenterProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Center dependency property.

See Also

CharacterReceivedEvent CharacterReceivedEvent CharacterReceivedEvent

Inherited from UIElement

CharacterSpacing CharacterSpacing CharacterSpacing

Inherited from Control

CharacterSpacingProperty CharacterSpacingProperty CharacterSpacingProperty

Inherited from Control

Children Children Children

Gets the collection of objects that are children of the MapControl.

public : IVector<DependencyObject> Children { get; }
public IList<DependencyObject> Children { get; }
Public ReadOnly Property Children As IList<DependencyObject>
Value
IVector<DependencyObject> IList<DependencyObject> IList<DependencyObject>

The collection of objects that are children of the MapControl.

Remarks

Display XAML user interface elements such as a Button, a HyperlinkButton, or a TextBlock by adding them as Children of the MapControl. You can also add them to the MapItemsControl, or bind the MapItemsControl to an item or a collection of items.

Alternately, to display pushpins, images, and shapes on the MapControl, add them to its MapElements collection.

For more info, see Display maps with 2D, 3D, and Streetside views.

See Also

ChildrenProperty ChildrenProperty ChildrenProperty

Identifies the Children dependency property.

public : static DependencyProperty ChildrenProperty { get; }
public static DependencyProperty ChildrenProperty { get; }
Public Static ReadOnly Property ChildrenProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Children dependency property.

See Also

Clip Clip Clip

Inherited from UIElement

ClipProperty ClipProperty ClipProperty

Inherited from UIElement

ColorScheme ColorScheme ColorScheme

Gets or sets the color scheme of the map – for example, light or dark.

public : MapColorScheme ColorScheme { get; set; }
public MapColorScheme ColorScheme { get; set; }
Public ReadWrite Property ColorScheme As MapColorScheme
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl ColorScheme="colorScheme" />
- or -
<Maps:MapControl>
    <Maps:MapControl.ColorScheme>colorScheme</Maps:MapControl.ColorScheme>
</Maps:MapControl>

Value
MapColorScheme MapColorScheme MapColorScheme

The color scheme of the map – for example, light or dark.

See Also

ColorSchemeProperty ColorSchemeProperty ColorSchemeProperty

Identifies the ColorScheme dependency property.

public : static DependencyProperty ColorSchemeProperty { get; }
public static DependencyProperty ColorSchemeProperty { get; }
Public Static ReadOnly Property ColorSchemeProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the ColorScheme dependency property.

See Also

CompositeMode CompositeMode CompositeMode

Inherited from UIElement

CompositeModeProperty CompositeModeProperty CompositeModeProperty

Inherited from UIElement

ContextFlyout ContextFlyout ContextFlyout

Inherited from UIElement

ContextFlyoutProperty ContextFlyoutProperty ContextFlyoutProperty

Inherited from UIElement

CustomExperience CustomExperience CustomExperience

Gets or sets a custom experience for the MapControl.

public : MapCustomExperience CustomExperience { get; set; }
public MapCustomExperience CustomExperience { get; set; }
Public ReadWrite Property CustomExperience As MapCustomExperience

Remarks

A custom experience changes the way a map appears in the MapControl. For example, the StreetsideExperience changes the perspective of the map to appear as though you were viewing a location from the street level.

DataContext DataContext DataContext

Inherited from FrameworkElement

DataContextProperty DataContextProperty DataContextProperty

Inherited from FrameworkElement

DefaultStyleKey DefaultStyleKey DefaultStyleKey

Inherited from Control

DefaultStyleKeyProperty DefaultStyleKeyProperty DefaultStyleKeyProperty

Inherited from Control

DefaultStyleResourceUri DefaultStyleResourceUri DefaultStyleResourceUri

Inherited from Control

DefaultStyleResourceUriProperty DefaultStyleResourceUriProperty DefaultStyleResourceUriProperty

Inherited from Control

DesiredPitch DesiredPitch DesiredPitch

Gets or sets a value that indicates by how many degrees you want the map to be tilted. Sometimes the desired pitch cannot be set.

public : double DesiredPitch { get; set; }
public double DesiredPitch { get; set; }
Public ReadWrite Property DesiredPitch As double
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl DesiredPitch="desiredPitch" />
- or -
<Maps:MapControl>
    <Maps:MapControl.DesiredPitch>desiredPitch</Maps:MapControl.DesiredPitch>
</Maps:MapControl>

Value
double double double

A value that indicates by how many degrees you want the map to be tilted. Sometimes the desired pitch cannot be set.

Remarks

For more information about pitch, see the remarks section of the MapCamera(Geopoint, Double, Double, Double, Double) overload.

The maximum and minimum values of pitch/tilt depend on the type of map view: 2D, 3D, or Streetside.

Property2D range3D rangeStreetside range
DesiredPitch0-750-900-180

See Also

DesiredPitchProperty DesiredPitchProperty DesiredPitchProperty

Identifies the DesiredPitch dependency property.

public : static DependencyProperty DesiredPitchProperty { get; }
public static DependencyProperty DesiredPitchProperty { get; }
Public Static ReadOnly Property DesiredPitchProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the DesiredPitch dependency property.

See Also

DesiredSize DesiredSize DesiredSize

Inherited from UIElement

Dispatcher Dispatcher Dispatcher

Inherited from DependencyObject

DoubleTappedEvent DoubleTappedEvent DoubleTappedEvent

Inherited from UIElement

DragEnterEvent DragEnterEvent DragEnterEvent

Inherited from UIElement

DragLeaveEvent DragLeaveEvent DragLeaveEvent

Inherited from UIElement

DragOverEvent DragOverEvent DragOverEvent

Inherited from UIElement

DropEvent DropEvent DropEvent

Inherited from UIElement

ElementSoundMode ElementSoundMode ElementSoundMode

Inherited from Control

ElementSoundModeProperty ElementSoundModeProperty ElementSoundModeProperty

Inherited from Control

ExitDisplayModeOnAccessKeyInvoked ExitDisplayModeOnAccessKeyInvoked ExitDisplayModeOnAccessKeyInvoked

Inherited from UIElement

ExitDisplayModeOnAccessKeyInvokedProperty ExitDisplayModeOnAccessKeyInvokedProperty ExitDisplayModeOnAccessKeyInvokedProperty

Inherited from UIElement

FlowDirection FlowDirection FlowDirection

Inherited from FrameworkElement

FlowDirectionProperty FlowDirectionProperty FlowDirectionProperty

Inherited from FrameworkElement

FocusState FocusState FocusState

Inherited from Control

FocusStateProperty FocusStateProperty FocusStateProperty

Inherited from Control

FocusVisualMargin FocusVisualMargin FocusVisualMargin

Inherited from FrameworkElement

FocusVisualMarginProperty FocusVisualMarginProperty FocusVisualMarginProperty

Inherited from FrameworkElement

FocusVisualPrimaryBrush FocusVisualPrimaryBrush FocusVisualPrimaryBrush

Inherited from FrameworkElement

FocusVisualPrimaryBrushProperty FocusVisualPrimaryBrushProperty FocusVisualPrimaryBrushProperty

Inherited from FrameworkElement

FocusVisualPrimaryThickness FocusVisualPrimaryThickness FocusVisualPrimaryThickness

Inherited from FrameworkElement

FocusVisualPrimaryThicknessProperty FocusVisualPrimaryThicknessProperty FocusVisualPrimaryThicknessProperty

Inherited from FrameworkElement

FocusVisualSecondaryBrush FocusVisualSecondaryBrush FocusVisualSecondaryBrush

Inherited from FrameworkElement

FocusVisualSecondaryBrushProperty FocusVisualSecondaryBrushProperty FocusVisualSecondaryBrushProperty

Inherited from FrameworkElement

FocusVisualSecondaryThickness FocusVisualSecondaryThickness FocusVisualSecondaryThickness

Inherited from FrameworkElement

FocusVisualSecondaryThicknessProperty FocusVisualSecondaryThicknessProperty FocusVisualSecondaryThicknessProperty

Inherited from FrameworkElement

FontFamily FontFamily FontFamily

Inherited from Control

FontFamilyProperty FontFamilyProperty FontFamilyProperty

Inherited from Control

FontSize FontSize FontSize

Inherited from Control

FontSizeProperty FontSizeProperty FontSizeProperty

Inherited from Control

FontStretch FontStretch FontStretch

Inherited from Control

FontStretchProperty FontStretchProperty FontStretchProperty

Inherited from Control

FontStyle FontStyle FontStyle

Inherited from Control

FontStyleProperty FontStyleProperty FontStyleProperty

Inherited from Control

FontWeight FontWeight FontWeight

Inherited from Control

FontWeightProperty FontWeightProperty FontWeightProperty

Inherited from Control

Foreground Foreground Foreground

Inherited from Control

ForegroundProperty ForegroundProperty ForegroundProperty

Inherited from Control

GettingFocusEvent GettingFocusEvent GettingFocusEvent

Inherited from UIElement

Heading Heading Heading

Gets or sets the directional heading of the map in degrees, where 0 or 360 = North, 90 = East, 180 = South, and 270 = West.

public : double Heading { get; set; }
public double Heading { get; set; }
Public ReadWrite Property Heading As double
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl Heading="heading"/>
- or -
<Maps:MapControl>
    <Maps:MapControl.Heading>heading</Maps:MapControl.Heading>
</Maps:MapControl>

Value
double double double

The directional heading of the map in degrees, where 0 or 360 = North, 90 = East, 180 = South, and 270 = West.

Remarks

Heading values greater than 360 degrees are normalized to their equivalent 0-360 degree value.

See Also

HeadingProperty HeadingProperty HeadingProperty

Identifies the Heading dependency property.

public : static DependencyProperty HeadingProperty { get; }
public static DependencyProperty HeadingProperty { get; }
Public Static ReadOnly Property HeadingProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Heading dependency property.

See Also

Height Height Height

Inherited from FrameworkElement

HeightProperty HeightProperty HeightProperty

Inherited from FrameworkElement

HighContrastAdjustment HighContrastAdjustment HighContrastAdjustment

Inherited from UIElement

HighContrastAdjustmentProperty HighContrastAdjustmentProperty HighContrastAdjustmentProperty

Inherited from UIElement

HoldingEvent HoldingEvent HoldingEvent

Inherited from UIElement

HorizontalAlignment HorizontalAlignment HorizontalAlignment

Inherited from FrameworkElement

HorizontalAlignmentProperty HorizontalAlignmentProperty HorizontalAlignmentProperty

Inherited from FrameworkElement

HorizontalContentAlignment HorizontalContentAlignment HorizontalContentAlignment

Inherited from Control

HorizontalContentAlignmentProperty HorizontalContentAlignmentProperty HorizontalContentAlignmentProperty

Inherited from Control

Is3DSupported Is3DSupported Is3DSupported

Gets a value that indicates if 3D is supported within the map.

public : Platform::Boolean Is3DSupported { get; }
public bool Is3DSupported { get; }
Public ReadOnly Property Is3DSupported As bool
Value
Platform::Boolean bool bool

true if 3D is supported within the map; otherwise, false.

Is3DSupportedProperty Is3DSupportedProperty Is3DSupportedProperty

Identifies the Is3DSupported dependency property.

public : static DependencyProperty Is3DSupportedProperty { get; }
public static DependencyProperty Is3DSupportedProperty { get; }
Public Static ReadOnly Property Is3DSupportedProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

Is the identifier for the Is3DSupported dependency property.

IsAccessKeyScope IsAccessKeyScope IsAccessKeyScope

Inherited from UIElement

IsAccessKeyScopeProperty IsAccessKeyScopeProperty IsAccessKeyScopeProperty

Inherited from UIElement

IsDoubleTapEnabled IsDoubleTapEnabled IsDoubleTapEnabled

Inherited from UIElement

IsDoubleTapEnabledProperty IsDoubleTapEnabledProperty IsDoubleTapEnabledProperty

Inherited from UIElement

IsEnabled IsEnabled IsEnabled

Inherited from Control

IsEnabledProperty IsEnabledProperty IsEnabledProperty

Inherited from Control

IsFocusEngaged IsFocusEngaged IsFocusEngaged

Inherited from Control

IsFocusEngagedProperty IsFocusEngagedProperty IsFocusEngagedProperty

Inherited from Control

IsFocusEngagementEnabled IsFocusEngagementEnabled IsFocusEngagementEnabled

Inherited from Control

IsFocusEngagementEnabledProperty IsFocusEngagementEnabledProperty IsFocusEngagementEnabledProperty

Inherited from Control

IsHitTestVisible IsHitTestVisible IsHitTestVisible

Inherited from UIElement

IsHitTestVisibleProperty IsHitTestVisibleProperty IsHitTestVisibleProperty

Inherited from UIElement

IsHoldingEnabled IsHoldingEnabled IsHoldingEnabled

Inherited from UIElement

IsHoldingEnabledProperty IsHoldingEnabledProperty IsHoldingEnabledProperty

Inherited from UIElement

IsRightTapEnabled IsRightTapEnabled IsRightTapEnabled

Inherited from UIElement

IsRightTapEnabledProperty IsRightTapEnabledProperty IsRightTapEnabledProperty

Inherited from UIElement

IsStreetsideSupported IsStreetsideSupported IsStreetsideSupported

Gets a value that indicates if Streetside is supported within the map.

public : Platform::Boolean IsStreetsideSupported { get; }
public bool IsStreetsideSupported { get; }
Public ReadOnly Property IsStreetsideSupported As bool
Value
Platform::Boolean bool bool

true if Streetside is supported within the map; otherwise, false.

IsStreetsideSupportedProperty IsStreetsideSupportedProperty IsStreetsideSupportedProperty

Identifies the IsStreetsideSupported dependency property.

public : static DependencyProperty IsStreetsideSupportedProperty { get; }
public static DependencyProperty IsStreetsideSupportedProperty { get; }
Public Static ReadOnly Property IsStreetsideSupportedProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

Is the identifier for the IsStreetsideSupported dependency property.

IsTabStop IsTabStop IsTabStop

Inherited from Control

IsTabStopProperty IsTabStopProperty IsTabStopProperty

Inherited from Control

IsTapEnabled IsTapEnabled IsTapEnabled

Inherited from UIElement

IsTapEnabledProperty IsTapEnabledProperty IsTapEnabledProperty

Inherited from UIElement

IsTemplateFocusTargetProperty IsTemplateFocusTargetProperty IsTemplateFocusTargetProperty

Inherited from Control

IsTemplateKeyTipTargetProperty IsTemplateKeyTipTargetProperty IsTemplateKeyTipTargetProperty

Inherited from Control

IsTextScaleFactorEnabled IsTextScaleFactorEnabled IsTextScaleFactorEnabled

Inherited from Control

IsTextScaleFactorEnabledProperty IsTextScaleFactorEnabledProperty IsTextScaleFactorEnabledProperty

Inherited from Control

KeyDownEvent KeyDownEvent KeyDownEvent

Inherited from UIElement

KeyTipHorizontalOffset KeyTipHorizontalOffset KeyTipHorizontalOffset

Inherited from UIElement

KeyTipHorizontalOffsetProperty KeyTipHorizontalOffsetProperty KeyTipHorizontalOffsetProperty

Inherited from UIElement

KeyTipPlacementMode KeyTipPlacementMode KeyTipPlacementMode

Inherited from UIElement

KeyTipPlacementModeProperty KeyTipPlacementModeProperty KeyTipPlacementModeProperty

Inherited from UIElement

KeyTipVerticalOffset KeyTipVerticalOffset KeyTipVerticalOffset

Inherited from UIElement

KeyTipVerticalOffsetProperty KeyTipVerticalOffsetProperty KeyTipVerticalOffsetProperty

Inherited from UIElement

KeyUpEvent KeyUpEvent KeyUpEvent

Inherited from UIElement

KeyboardAccelerators KeyboardAccelerators KeyboardAccelerators

Inherited from UIElement

LandmarksVisible LandmarksVisible LandmarksVisible

Gets or sets a value that indicates whether 3D buildings are displayed on the map.

public : Platform::Boolean LandmarksVisible { get; set; }
public bool LandmarksVisible { get; set; }
Public ReadWrite Property LandmarksVisible As bool
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl LandmarksVisible="landmarksVisible"/>
- or -
<Maps:MapControl>
    <Maps:MapControl.LandmarksVisible>landmarksVisible</Maps:MapControl.LandmarksVisible>
</Maps:MapControl>

Value
Platform::Boolean bool bool

true if 3D buildings are displayed on the map; otherwise, false.

See Also

LandmarksVisibleProperty LandmarksVisibleProperty LandmarksVisibleProperty

Identifies the LandmarksVisible dependency property.

public : static DependencyProperty LandmarksVisibleProperty { get; }
public static DependencyProperty LandmarksVisibleProperty { get; }
Public Static ReadOnly Property LandmarksVisibleProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the LandmarksVisible dependency property.

See Also

Language Language Language

Inherited from FrameworkElement

LanguageProperty LanguageProperty LanguageProperty

Inherited from FrameworkElement

Layers Layers Layers

Gets the collection of MapLayer objects that are children of the MapControl.

public : IVector<MapLayer> Layers { get; set; }
public IList<MapLayer> Layers { get; set; }
Public ReadWrite Property Layers As IList<MapLayer>
Value
IVector<MapLayer> IList<MapLayer> IList<MapLayer>

The collection of MapLayer objects that are children of the MapControl.

Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

LayersProperty LayersProperty LayersProperty

Identifies the Layers dependency property.

public : static DependencyProperty LayersProperty { get; }
public static DependencyProperty LayersProperty { get; }
Public Static ReadOnly Property LayersProperty As DependencyProperty
Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

Lights Lights Lights

Inherited from UIElement

LightsProperty LightsProperty LightsProperty

Inherited from UIElement

LoadingStatus LoadingStatus LoadingStatus

Gets the loading status of the map to be displayed in the MapControl.

public : MapLoadingStatus LoadingStatus { get; }
public MapLoadingStatus LoadingStatus { get; }
Public ReadOnly Property LoadingStatus As MapLoadingStatus
Value
MapLoadingStatus MapLoadingStatus MapLoadingStatus

The loading status of the map to be displayed in the MapControl.

See Also

LoadingStatusProperty LoadingStatusProperty LoadingStatusProperty

Identifies the LoadingStatus dependency property.

public : static DependencyProperty LoadingStatusProperty { get; }
public static DependencyProperty LoadingStatusProperty { get; }
Public Static ReadOnly Property LoadingStatusProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the LoadingStatus dependency property.

See Also

LocationProperty LocationProperty LocationProperty

Identifies the MapControl.Location XAML attached property.

public : static DependencyProperty LocationProperty { get; }
public static DependencyProperty LocationProperty { get; }
Public Static ReadOnly Property LocationProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the MapControl.Location XAML attached property.

See Also

LosingFocusEvent LosingFocusEvent LosingFocusEvent

Inherited from UIElement

ManipulationCompletedEvent ManipulationCompletedEvent ManipulationCompletedEvent

Inherited from UIElement

ManipulationDeltaEvent ManipulationDeltaEvent ManipulationDeltaEvent

Inherited from UIElement

ManipulationInertiaStartingEvent ManipulationInertiaStartingEvent ManipulationInertiaStartingEvent

Inherited from UIElement

ManipulationMode ManipulationMode ManipulationMode

Inherited from UIElement

ManipulationModeProperty ManipulationModeProperty ManipulationModeProperty

Inherited from UIElement

ManipulationStartedEvent ManipulationStartedEvent ManipulationStartedEvent

Inherited from UIElement

ManipulationStartingEvent ManipulationStartingEvent ManipulationStartingEvent

Inherited from UIElement

MapElements MapElements MapElements

Gets the collection of MapElement objects that are children of the MapControl.

public : IVector<MapElement> MapElements { get; }
public IList<MapElement> MapElements { get; }
Public ReadOnly Property MapElements As IList<MapElement>
Value
IVector<MapElement> IList<MapElement> IList<MapElement>

The collection of MapElement objects that are children of the MapControl.

Remarks

Note

In the Windows 10 Fall Creators Update, we recommend that you add MapElement objects to a MapElementsLayer instead of adding them to the MapElements collection.

Display pushpins, images, and shapes on the MapControl by adding them to its MapElements collection.

  • Display an image such as a pushpin with optional text by using the MapIcon class. Keep the default image or provide a custom image.
  • Define and display a MapPolygon or a MapPolyline. Alternately, to display XAML elements on the MapControl, add them to its Children collection.

For more info, see Display maps with 2D, 3D, and Streetside views.

See Also

MapElementsProperty MapElementsProperty MapElementsProperty

Identifies the MapElements dependency property.

public : static DependencyProperty MapElementsProperty { get; }
public static DependencyProperty MapElementsProperty { get; }
Public Static ReadOnly Property MapElementsProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the MapElements dependency property.

See Also

MapProjection MapProjection MapProjection

Gets or sets a MapProjection that specifies how to transform the latitudes and longitudes of the map.

public : MapProjection MapProjection { get; set; }
public MapProjection MapProjection { get; set; }
Public ReadWrite Property MapProjection As MapProjection
Value
MapProjection MapProjection MapProjection

An MapProjection that specifies how to transform the latitudes and longitudes of the map.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

MapProjectionProperty MapProjectionProperty MapProjectionProperty

Identifies the MapProjection dependency property.

public : static DependencyProperty MapProjectionProperty { get; }
public static DependencyProperty MapProjectionProperty { get; }
Public Static ReadOnly Property MapProjectionProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the MapProjection dependency property.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

MapServiceToken MapServiceToken MapServiceToken

Gets or sets the authentication key required for using the MapControl and online mapping services.

public : Platform::String MapServiceToken { get; set; }
public string MapServiceToken { get; set; }
Public ReadWrite Property MapServiceToken As string
Value
Platform::String string string

The authentication key required for using the MapControl and online mapping services.

See Also

MapServiceTokenProperty MapServiceTokenProperty MapServiceTokenProperty

Identifies the MapServiceToken dependency property.

public : static DependencyProperty MapServiceTokenProperty { get; }
public static DependencyProperty MapServiceTokenProperty { get; }
Public Static ReadOnly Property MapServiceTokenProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the MapServiceToken dependency property.

See Also

Margin Margin Margin

Inherited from FrameworkElement

MarginProperty MarginProperty MarginProperty

Inherited from FrameworkElement

MaxHeight MaxHeight MaxHeight

Inherited from FrameworkElement

MaxHeightProperty MaxHeightProperty MaxHeightProperty

Inherited from FrameworkElement

MaxWidth MaxWidth MaxWidth

Inherited from FrameworkElement

MaxWidthProperty MaxWidthProperty MaxWidthProperty

Inherited from FrameworkElement

MaxZoomLevel MaxZoomLevel MaxZoomLevel

Gets the maximum zoom level for the map.

public : double MaxZoomLevel { get; }
public double MaxZoomLevel { get; }
Public ReadOnly Property MaxZoomLevel As double
Value
double double double

The maximum zoom level for the map.

Remarks

The maximum and minimum values of ZoomLevel depend on the type of map view: 2D, 3D, or Streetside.

Property2D range3D rangeStreetside range
ZoomLevel1-201-2024-26

See Also

MinHeight MinHeight MinHeight

Inherited from FrameworkElement

MinHeightProperty MinHeightProperty MinHeightProperty

Inherited from FrameworkElement

MinWidth MinWidth MinWidth

Inherited from FrameworkElement

MinWidthProperty MinWidthProperty MinWidthProperty

Inherited from FrameworkElement

MinZoomLevel MinZoomLevel MinZoomLevel

Gets the minimum zoom level for the map.

public : double MinZoomLevel { get; }
public double MinZoomLevel { get; }
Public ReadOnly Property MinZoomLevel As double
Value
double double double

The minimum zoom level for the map.

Remarks

See the remarks section of the MaxZoomLevel property.

See Also

Name Name Name

Inherited from FrameworkElement

NameProperty NameProperty NameProperty

Inherited from FrameworkElement

NoFocusCandidateFoundEvent NoFocusCandidateFoundEvent NoFocusCandidateFoundEvent

Inherited from UIElement

NormalizedAnchorPointProperty NormalizedAnchorPointProperty NormalizedAnchorPointProperty

Identifies the MapControl.NormalizedAnchorPoint XAML attached property.

public : static DependencyProperty NormalizedAnchorPointProperty { get; }
public static DependencyProperty NormalizedAnchorPointProperty { get; }
Public Static ReadOnly Property NormalizedAnchorPointProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the MapControl.NormalizedAnchorPoint XAML attached property.

See Also

Opacity Opacity Opacity

Inherited from UIElement

OpacityProperty OpacityProperty OpacityProperty

Inherited from UIElement

Padding Padding Padding

Inherited from Control

PaddingProperty PaddingProperty PaddingProperty

Inherited from Control

PanInteractionMode PanInteractionMode PanInteractionMode

Gets or sets a value that indicates if the pan gesture is recognized on the map.

public : MapPanInteractionMode PanInteractionMode { get; set; }
public MapPanInteractionMode PanInteractionMode { get; set; }
Public ReadWrite Property PanInteractionMode As MapPanInteractionMode
Value
MapPanInteractionMode MapPanInteractionMode MapPanInteractionMode

A value that indicates if the pan gesture is recognized on the map.

PanInteractionModeProperty PanInteractionModeProperty PanInteractionModeProperty

Identifies the PanInteractionMode dependency property.

public : static DependencyProperty PanInteractionModeProperty { get; }
public static DependencyProperty PanInteractionModeProperty { get; }
Public Static ReadOnly Property PanInteractionModeProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

Identifier for the PanInteractionMode dependency property.

Parent Parent Parent

Inherited from FrameworkElement

PedestrianFeaturesVisible PedestrianFeaturesVisible PedestrianFeaturesVisible

Gets or sets a value that indicates whether pedestrian features such as public stairs are displayed on the map.

public : Platform::Boolean PedestrianFeaturesVisible { get; set; }
public bool PedestrianFeaturesVisible { get; set; }
Public ReadWrite Property PedestrianFeaturesVisible As bool
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl PedestrianFeaturesVisible="pedestrianFeaturesVisible"/>
- or -
<Maps:MapControl>
    <Maps:MapControl.PedestrianFeaturesVisible>pedestrianFeaturesVisible</Maps:MapControl.PedestrianFeaturesVisible>
</Maps:MapControl>

Value
Platform::Boolean bool bool

true if pedestrian features such as public stairs are displayed on the map; otherwise, false.

See Also

PedestrianFeaturesVisibleProperty PedestrianFeaturesVisibleProperty PedestrianFeaturesVisibleProperty

Identifies the PedestrianFeaturesVisible dependency property.

public : static DependencyProperty PedestrianFeaturesVisibleProperty { get; }
public static DependencyProperty PedestrianFeaturesVisibleProperty { get; }
Public Static ReadOnly Property PedestrianFeaturesVisibleProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the PedestrianFeaturesVisible dependency property.

See Also

Pitch Pitch Pitch

Gets the actual pitch of the map. Sometimes the pitch requested by setting the DesiredPitch property cannot be set.

public : double Pitch { get; }
public double Pitch { get; }
Public ReadOnly Property Pitch As double
Value
double double double

The actual pitch of the map. Sometimes the pitch requested by setting the property cannot be set.

See Also

PitchProperty PitchProperty PitchProperty

Identifies the Pitch dependency property.

public : static DependencyProperty PitchProperty { get; }
public static DependencyProperty PitchProperty { get; }
Public Static ReadOnly Property PitchProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Pitch dependency property.

See Also

PointerCanceledEvent PointerCanceledEvent PointerCanceledEvent

Inherited from UIElement

PointerCaptureLostEvent PointerCaptureLostEvent PointerCaptureLostEvent

Inherited from UIElement

PointerCaptures PointerCaptures PointerCaptures

Inherited from UIElement

PointerCapturesProperty PointerCapturesProperty PointerCapturesProperty

Inherited from UIElement

PointerEnteredEvent PointerEnteredEvent PointerEnteredEvent

Inherited from UIElement

PointerExitedEvent PointerExitedEvent PointerExitedEvent

Inherited from UIElement

PointerMovedEvent PointerMovedEvent PointerMovedEvent

Inherited from UIElement

PointerPressedEvent PointerPressedEvent PointerPressedEvent

Inherited from UIElement

PointerReleasedEvent PointerReleasedEvent PointerReleasedEvent

Inherited from UIElement

PointerWheelChangedEvent PointerWheelChangedEvent PointerWheelChangedEvent

Inherited from UIElement

PreviewKeyDownEvent PreviewKeyDownEvent PreviewKeyDownEvent

Inherited from UIElement

PreviewKeyUpEvent PreviewKeyUpEvent PreviewKeyUpEvent

Inherited from UIElement

Projection Projection Projection

Inherited from UIElement

ProjectionProperty ProjectionProperty ProjectionProperty

Inherited from UIElement

RenderSize RenderSize RenderSize

Inherited from UIElement

RenderTransform RenderTransform RenderTransform

Inherited from UIElement

RenderTransformOrigin RenderTransformOrigin RenderTransformOrigin

Inherited from UIElement

RenderTransformOriginProperty RenderTransformOriginProperty RenderTransformOriginProperty

Inherited from UIElement

RenderTransformProperty RenderTransformProperty RenderTransformProperty

Inherited from UIElement

RequestedTheme RequestedTheme RequestedTheme

Inherited from FrameworkElement

RequestedThemeProperty RequestedThemeProperty RequestedThemeProperty

Inherited from FrameworkElement

RequiresPointer RequiresPointer RequiresPointer

Inherited from Control

RequiresPointerProperty RequiresPointerProperty RequiresPointerProperty

Inherited from Control

Resources Resources Resources

Inherited from FrameworkElement

RightTappedEvent RightTappedEvent RightTappedEvent

Inherited from UIElement

RotateInteractionMode RotateInteractionMode RotateInteractionMode

Gets or sets a value that indicates if the map responds to the rotate gesture and if the corresponding UI control appears on the map.

public : MapInteractionMode RotateInteractionMode { get; set; }
public MapInteractionMode RotateInteractionMode { get; set; }
Public ReadWrite Property RotateInteractionMode As MapInteractionMode
Value
MapInteractionMode MapInteractionMode MapInteractionMode

A value that specifies if the map responds to the rotate gesture and if the corresponding UI control appears on the map.

RotateInteractionModeProperty RotateInteractionModeProperty RotateInteractionModeProperty

Identifies the RotateInteractionMode dependency property.

public : static DependencyProperty RotateInteractionModeProperty { get; }
public static DependencyProperty RotateInteractionModeProperty { get; }
Public Static ReadOnly Property RotateInteractionModeProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

Identifier for the RotateInteractionMode dependency property.

Routes Routes Routes

Gets the collection of MapRouteView objects displayed on the map.

public : IVector<MapRouteView> Routes { get; }
public IList<MapRouteView> Routes { get; }
Public ReadOnly Property Routes As IList<MapRouteView>
Value
IVector<MapRouteView> IList<MapRouteView> IList<MapRouteView>

The collection of MapRouteView objects displayed on the map.

Remarks

To display a route on a map, construct a MapRouteView with the MapRoute and add the MapRouteView to the Routes collection of the MapControl.

See Also

RoutesProperty RoutesProperty RoutesProperty

Identifies the Routes dependency property.

public : static DependencyProperty RoutesProperty { get; }
public static DependencyProperty RoutesProperty { get; }
Public Static ReadOnly Property RoutesProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Routes dependency property.

See Also

Scene Scene Scene

Gets or sets the MapScene associated with this MapControl.

public : MapScene Scene { get; set; }
public MapScene Scene { get; set; }
Public ReadWrite Property Scene As MapScene
Value
MapScene MapScene MapScene

The MapScene associated with this MapControl.

Remarks

Setting the scene is a synchronous operation, there is no animation involved.

SceneProperty SceneProperty SceneProperty

Identifies the Scene dependency property.

public : static DependencyProperty SceneProperty { get; }
public static DependencyProperty SceneProperty { get; }
Public Static ReadOnly Property SceneProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Scene dependency property.

See Also

Style Style Style

Specifies the style of the map - for example, a road map or an aerial map.

public : MapStyle Style { get; set; }
public MapStyle Style { get; set; }
Public ReadWrite Property Style As MapStyle
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl Style="style" />
- or -
<Maps:MapControl>
    <Maps:MapControl.Style>style</Maps:MapControl.Style>
</Maps:MapControl>

Value
MapStyle MapStyle MapStyle

The style of the map - for example, a road map or an aerial map.

Remarks

Important

Aerial styles are not available when the network is disconnected from the internet.

See Also

Style Style Style

Inherited from FrameworkElement

StyleProperty StyleProperty StyleProperty

Inherited from FrameworkElement

StyleProperty StyleProperty StyleProperty

Identifies the Style dependency property.

public : static DependencyProperty StyleProperty { get; }
public static DependencyProperty StyleProperty { get; }
Public Static ReadOnly Property StyleProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Style dependency property.

See Also

StyleSheet StyleSheet StyleSheet

Gets or sets an object that defines the style of the map control.

public : MapStyleSheet StyleSheet { get; set; }
public MapStyleSheet StyleSheet { get; set; }
Public ReadWrite Property StyleSheet As MapStyleSheet
Value
MapStyleSheet MapStyleSheet MapStyleSheet

An object that defines the style of the map control.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

Examples

The following example sets the StyleSheet property by using the static MapControl.RoadDark method.


  myMap.StyleSheet = MapStyleSheet.RoadDark();

StyleSheetProperty StyleSheetProperty StyleSheetProperty

Identifies the StyleSheet dependency property.

public : static DependencyProperty StyleSheetProperty { get; }
public static DependencyProperty StyleSheetProperty { get; }
Public Static ReadOnly Property StyleSheetProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the StyleSheet dependency property.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

TabFocusNavigation TabFocusNavigation TabFocusNavigation

Inherited from UIElement

TabFocusNavigationProperty TabFocusNavigationProperty TabFocusNavigationProperty

Inherited from UIElement

TabIndex TabIndex TabIndex

Inherited from Control

TabIndexProperty TabIndexProperty TabIndexProperty

Inherited from Control

TabNavigation TabNavigation TabNavigation

Inherited from Control

TabNavigationProperty TabNavigationProperty TabNavigationProperty

Inherited from Control

Tag Tag Tag

Inherited from FrameworkElement

TagProperty TagProperty TagProperty

Inherited from FrameworkElement

TappedEvent TappedEvent TappedEvent

Inherited from UIElement

TargetCamera TargetCamera TargetCamera

Gets the MapCamera settings that define the final position of the camera.

public : MapCamera TargetCamera { get; }
public MapCamera TargetCamera { get; }
Public ReadOnly Property TargetCamera As MapCamera
Value
MapCamera MapCamera MapCamera

The MapCamera settings that define the final position of the camera.

Remarks

During an animation of the map, the ActualCamera defines the current position of the map's camera and TargetCamera defines the final position of the camera.

Template Template Template

Inherited from Control

TemplateProperty TemplateProperty TemplateProperty

Inherited from Control

TileSources TileSources TileSources

Gets or sets the collection of MapTileSource objects that are children of the MapControl.

public : IVector<MapTileSource> TileSources { get; }
public IList<MapTileSource> TileSources { get; }
Public ReadOnly Property TileSources As IList<MapTileSource>
Value
IVector<MapTileSource> IList<MapTileSource> IList<MapTileSource>

The collection of MapTileSource objects that are children of the MapControl.

See Also

TileSourcesProperty TileSourcesProperty TileSourcesProperty

Identifies the TileSources dependency property.

public : static DependencyProperty TileSourcesProperty { get; }
public static DependencyProperty TileSourcesProperty { get; }
Public Static ReadOnly Property TileSourcesProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the TileSources dependency property.

See Also

TiltInteractionMode TiltInteractionMode TiltInteractionMode

Gets or sets a value that indicates if the map responds to the tilt gesture and if the corresponding UI control appears on the map.

public : MapInteractionMode TiltInteractionMode { get; set; }
public MapInteractionMode TiltInteractionMode { get; set; }
Public ReadWrite Property TiltInteractionMode As MapInteractionMode
Value
MapInteractionMode MapInteractionMode MapInteractionMode

A value that specifies if the map responds to the tilt gesture and if the corresponding UI control appears on the map.

TiltInteractionModeProperty TiltInteractionModeProperty TiltInteractionModeProperty

Identifies the TiltInteractionMode dependency property.

public : static DependencyProperty TiltInteractionModeProperty { get; }
public static DependencyProperty TiltInteractionModeProperty { get; }
Public Static ReadOnly Property TiltInteractionModeProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

Identifier for the TiltInteractionMode dependency property.

TrafficFlowVisible TrafficFlowVisible TrafficFlowVisible

Gets or sets a value that indicates whether traffic conditions are displayed on the map.

public : Platform::Boolean TrafficFlowVisible { get; set; }
public bool TrafficFlowVisible { get; set; }
Public ReadWrite Property TrafficFlowVisible As bool
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl TrafficFlowVisible="trafficFlowVisible"/>
- or -
<Maps:MapControl>
    <Maps:MapControl.TrafficFlowVisible>trafficFlowVisible</Maps:MapControl.TrafficFlowVisible>
</Maps:MapControl>

Value
Platform::Boolean bool bool

true if traffic conditions are displayed on the map; otherwise, false.

See Also

TrafficFlowVisibleProperty TrafficFlowVisibleProperty TrafficFlowVisibleProperty

Identifies the TrafficFlowVisible dependency property.

public : static DependencyProperty TrafficFlowVisibleProperty { get; }
public static DependencyProperty TrafficFlowVisibleProperty { get; }
Public Static ReadOnly Property TrafficFlowVisibleProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the TrafficFlowVisible dependency property.

See Also

Transform3D Transform3D Transform3D

Inherited from UIElement

Transform3DProperty Transform3DProperty Transform3DProperty

Inherited from UIElement

TransformOrigin TransformOrigin TransformOrigin

Gets or sets a point to which the logical center of the map is transformed.

public : Point TransformOrigin { get; set; }
public Point TransformOrigin { get; set; }
Public ReadWrite Property TransformOrigin As Point
Value
Point Point Point

A point to which the logical center of the map is transformed. Use a value between 0 and 1 (but not 0 or 1) for the X and Y properties of the Point.

Remarks

The TransformOrigin represents a point around which the map rotates – for example, when the user manipulates the map, or when you change the value of the Heading property. Consider setting the Y value of the TransformOrigin to a value greater than 0.5 when the map is tilted - that is, when the Pitch is greater than 0. This moves the logical center closer to the user - that is, closer to the bottom of the screen - and shows the user more of what’s in the distance when the map is rotated.

After you set the value of the TransformOrigin property for the MapControl, the Center property continues to return the previous center until you set the Center to the same value as the TransformOrigin.

See Also

TransformOriginProperty TransformOriginProperty TransformOriginProperty

Identifies the TransformOrigin dependency property.

public : static DependencyProperty TransformOriginProperty { get; }
public static DependencyProperty TransformOriginProperty { get; }
Public Static ReadOnly Property TransformOriginProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the TransformOrigin dependency property.

See Also

TransitFeaturesEnabled TransitFeaturesEnabled TransitFeaturesEnabled

This property is not implemented.

public : Platform::Boolean TransitFeaturesEnabled { get; set; }
public bool TransitFeaturesEnabled { get; set; }
Public ReadWrite Property TransitFeaturesEnabled As bool
Value
Platform::Boolean bool bool

This property is not implemented.

Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

TransitFeaturesEnabledProperty TransitFeaturesEnabledProperty TransitFeaturesEnabledProperty

This property is not implemented.

public : static DependencyProperty TransitFeaturesEnabledProperty { get; }
public static DependencyProperty TransitFeaturesEnabledProperty { get; }
Public Static ReadOnly Property TransitFeaturesEnabledProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

This property is not implemented.

Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

TransitFeaturesVisible TransitFeaturesVisible TransitFeaturesVisible

Gets or sets a value that indicates if transit features are displayed on the map.

public : Platform::Boolean TransitFeaturesVisible { get; set; }
public bool TransitFeaturesVisible { get; set; }
Public ReadWrite Property TransitFeaturesVisible As bool
Value
Platform::Boolean bool bool

true if transit features are displayed on the map; otherwise, false.

TransitFeaturesVisibleProperty TransitFeaturesVisibleProperty TransitFeaturesVisibleProperty

Identifies the TransitFeaturesVisible dependency property.

public : static DependencyProperty TransitFeaturesVisibleProperty { get; }
public static DependencyProperty TransitFeaturesVisibleProperty { get; }
Public Static ReadOnly Property TransitFeaturesVisibleProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the TransitFeaturesVisible dependency property.

Transitions Transitions Transitions

Inherited from UIElement

TransitionsProperty TransitionsProperty TransitionsProperty

Inherited from UIElement

Triggers Triggers Triggers

Inherited from FrameworkElement

UseLayoutRounding UseLayoutRounding UseLayoutRounding

Inherited from UIElement

UseLayoutRoundingProperty UseLayoutRoundingProperty UseLayoutRoundingProperty

Inherited from UIElement

UseSystemFocusVisuals UseSystemFocusVisuals UseSystemFocusVisuals

Inherited from Control

UseSystemFocusVisualsProperty UseSystemFocusVisualsProperty UseSystemFocusVisualsProperty

Inherited from Control

VerticalAlignment VerticalAlignment VerticalAlignment

Inherited from FrameworkElement

VerticalAlignmentProperty VerticalAlignmentProperty VerticalAlignmentProperty

Inherited from FrameworkElement

VerticalContentAlignment VerticalContentAlignment VerticalContentAlignment

Inherited from Control

VerticalContentAlignmentProperty VerticalContentAlignmentProperty VerticalContentAlignmentProperty

Inherited from Control

ViewPadding ViewPadding ViewPadding

Gets or sets the padding inside a map control.

public : Thickness ViewPadding { get; set; }
public Thickness ViewPadding { get; set; }
Public ReadWrite Property ViewPadding As Thickness
Value
Thickness Thickness Thickness

The amount of space between the content of a MapControl and its Margin or Border. The default is a Thickness with values of 0 on all four sides.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

Remarks

For more information about how this property behaves, see the Control.Padding property.

ViewPaddingProperty ViewPaddingProperty ViewPaddingProperty

Identifies the ViewPadding dependency property.

public : static DependencyProperty ViewPaddingProperty { get; }
public static DependencyProperty ViewPaddingProperty { get; }
Public Static ReadOnly Property ViewPaddingProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the ViewPadding dependency property.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

Visibility Visibility Visibility

Inherited from UIElement

VisibilityProperty VisibilityProperty VisibilityProperty

Inherited from UIElement

WatermarkMode WatermarkMode WatermarkMode

Gets or sets a value that determines when the watermark of the map is displayed.

public : MapWatermarkMode WatermarkMode { get; set; }
public MapWatermarkMode WatermarkMode { get; set; }
Public ReadWrite Property WatermarkMode As MapWatermarkMode
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl WatermarkMode="watermarkMode"/>
- or -
<Maps:MapControl>
    <Maps:MapControl.WatermarkMode>watermarkMode</Maps:MapControl.WatermarkMode>
</Maps:MapControl>

Value
MapWatermarkMode MapWatermarkMode MapWatermarkMode

A value that determines when the watermark of the map is displayed.

See Also

WatermarkModeProperty WatermarkModeProperty WatermarkModeProperty

Identifies the WatermarkMode dependency property.

public : static DependencyProperty WatermarkModeProperty { get; }
public static DependencyProperty WatermarkModeProperty { get; }
Public Static ReadOnly Property WatermarkModeProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the WatermarkMode dependency property.

See Also

Width Width Width

Inherited from FrameworkElement

WidthProperty WidthProperty WidthProperty

Inherited from FrameworkElement

XYFocusDown XYFocusDown XYFocusDown

Inherited from Control

XYFocusDownNavigationStrategy XYFocusDownNavigationStrategy XYFocusDownNavigationStrategy

Inherited from UIElement

XYFocusDownNavigationStrategyProperty XYFocusDownNavigationStrategyProperty XYFocusDownNavigationStrategyProperty

Inherited from UIElement

XYFocusDownProperty XYFocusDownProperty XYFocusDownProperty

Inherited from Control

XYFocusKeyboardNavigation XYFocusKeyboardNavigation XYFocusKeyboardNavigation

Inherited from UIElement

XYFocusKeyboardNavigationProperty XYFocusKeyboardNavigationProperty XYFocusKeyboardNavigationProperty

Inherited from UIElement

XYFocusLeft XYFocusLeft XYFocusLeft

Inherited from Control

XYFocusLeftNavigationStrategy XYFocusLeftNavigationStrategy XYFocusLeftNavigationStrategy

Inherited from UIElement

XYFocusLeftNavigationStrategyProperty XYFocusLeftNavigationStrategyProperty XYFocusLeftNavigationStrategyProperty

Inherited from UIElement

XYFocusLeftProperty XYFocusLeftProperty XYFocusLeftProperty

Inherited from Control

XYFocusRight XYFocusRight XYFocusRight

Inherited from Control

XYFocusRightNavigationStrategy XYFocusRightNavigationStrategy XYFocusRightNavigationStrategy

Inherited from UIElement

XYFocusRightNavigationStrategyProperty XYFocusRightNavigationStrategyProperty XYFocusRightNavigationStrategyProperty

Inherited from UIElement

XYFocusRightProperty XYFocusRightProperty XYFocusRightProperty

Inherited from Control

XYFocusUp XYFocusUp XYFocusUp

Inherited from Control

XYFocusUpNavigationStrategy XYFocusUpNavigationStrategy XYFocusUpNavigationStrategy

Inherited from UIElement

XYFocusUpNavigationStrategyProperty XYFocusUpNavigationStrategyProperty XYFocusUpNavigationStrategyProperty

Inherited from UIElement

XYFocusUpProperty XYFocusUpProperty XYFocusUpProperty

Inherited from Control

ZoomInteractionMode ZoomInteractionMode ZoomInteractionMode

Gets or sets a value that indicates if the map responds to the zoom gesture and if the corresponding UI control appears on the map.

public : MapInteractionMode ZoomInteractionMode { get; set; }
public MapInteractionMode ZoomInteractionMode { get; set; }
Public ReadWrite Property ZoomInteractionMode As MapInteractionMode
Value
MapInteractionMode MapInteractionMode MapInteractionMode

A value that specifies if the map responds to the zoom gesture and if the corresponding UI control appears on the map.

ZoomInteractionModeProperty ZoomInteractionModeProperty ZoomInteractionModeProperty

Identifies the ZoomInteractionMode dependency property.

public : static DependencyProperty ZoomInteractionModeProperty { get; }
public static DependencyProperty ZoomInteractionModeProperty { get; }
Public Static ReadOnly Property ZoomInteractionModeProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

Identifier for the ZoomInteractionMode dependency property.

ZoomLevel ZoomLevel ZoomLevel

Gets or sets the zoom level of the map, which is a value between 1 and 20 in 2D views.

public : double ZoomLevel { get; set; }
public double ZoomLevel { get; set; }
Public ReadWrite Property ZoomLevel As double
<!-- xmlns:Maps="using:Windows.UI.Xaml.Controls.Maps" -->

<Maps:MapControl ZoomLevel="zoomLevel"/>
- or -
<Maps:MapControl>
    <Maps:MapControl.ZoomLevel>zoomLevel</Maps:MapControl.ZoomLevel>
</Maps:MapControl>

Value
double double double

The zoom level of the map, which is a value between 1 and 20 in 2D views.

Remarks

See the remarks section of the TryZoomInAsync method.

See Also

ZoomLevelProperty ZoomLevelProperty ZoomLevelProperty

Identifies the ZoomLevel dependency property.

public : static DependencyProperty ZoomLevelProperty { get; }
public static DependencyProperty ZoomLevelProperty { get; }
Public Static ReadOnly Property ZoomLevelProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the ZoomLevel dependency property.

See Also

Methods

AddHandler(RoutedEvent,Object,Boolean) AddHandler(RoutedEvent,Object,Boolean) AddHandler(RoutedEvent,Object,Boolean)

Inherited from UIElement

ApplyTemplate ApplyTemplate ApplyTemplate

Inherited from Control

Arrange(Rect) Arrange(Rect) Arrange(Rect)

Inherited from UIElement

ArrangeOverride(Size) ArrangeOverride(Size) ArrangeOverride(Size)

Inherited from FrameworkElement

CancelDirectManipulations CancelDirectManipulations CancelDirectManipulations

Inherited from UIElement

CapturePointer(Pointer) CapturePointer(Pointer) CapturePointer(Pointer)

Inherited from UIElement

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Inherited from DependencyObject

DeferTree(DependencyObject) DeferTree(DependencyObject) DeferTree(DependencyObject)

Inherited from FrameworkElement

FindMapElementsAtOffset(Point) FindMapElementsAtOffset(Point) FindMapElementsAtOffset(Point)

Retrieves the collection of MapElement objects at the specified point on the map.

public : IVectorView<MapElement> FindMapElementsAtOffset(Point offset)
public IReadOnlyList<MapElement> FindMapElementsAtOffset(Point offset)
Public Function FindMapElementsAtOffset(offset As Point) As IReadOnlyList<MapElement>( Of MapElement )
Parameters
offset
Point Point Point

The point on the map from which to retrieve the collection of MapElement objects.

Returns
IVectorView<MapElement> IReadOnlyList<MapElement> IReadOnlyList<MapElement>

The collection of MapElement objects at the specified point on the map.

See Also

FindMapElementsAtOffset(Point, Double) FindMapElementsAtOffset(Point, Double) FindMapElementsAtOffset(Point, Double)

Retrieves the collection of MapElement objects within the specified radius.

public : IVectorView<MapElement> FindMapElementsAtOffset(Point offset, double radius)
public IReadOnlyList<MapElement> FindMapElementsAtOffset(Point offset, Double radius)
Public Function FindMapElementsAtOffset(offset As Point, radius As Double) As IReadOnlyList<MapElement>( Of MapElement )
Parameters
offset
Point Point Point

The point on the map that marks the center of a radius from which to retrieve the collection of MapElement objects.

radius
double Double Double

A number that's added to the offset to mark the edge of the radius.

Returns
IVectorView<MapElement> IReadOnlyList<MapElement> IReadOnlyList<MapElement>

The collection of MapElement objects within the specified radius.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

Remarks

Use this overload to retrieve a collection of map objects by using a hit test area that your app captures from touch interactions.

See Also

FindName(String) FindName(String) FindName(String)

Inherited from FrameworkElement

FindSubElementsForTouchTargeting(Point,Rect) FindSubElementsForTouchTargeting(Point,Rect) FindSubElementsForTouchTargeting(Point,Rect)

Inherited from UIElement

Focus(FocusState) Focus(FocusState) Focus(FocusState)

Inherited from Control

GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty)

Inherited from DependencyObject

GetBindingExpression(DependencyProperty) GetBindingExpression(DependencyProperty) GetBindingExpression(DependencyProperty)

Inherited from FrameworkElement

GetChildrenInTabFocusOrder GetChildrenInTabFocusOrder GetChildrenInTabFocusOrder

Inherited from UIElement

GetIsTemplateFocusTarget(FrameworkElement) GetIsTemplateFocusTarget(FrameworkElement) GetIsTemplateFocusTarget(FrameworkElement)

Inherited from Control

GetIsTemplateKeyTipTarget(DependencyObject) GetIsTemplateKeyTipTarget(DependencyObject) GetIsTemplateKeyTipTarget(DependencyObject)

Inherited from Control

GetLocation(DependencyObject) GetLocation(DependencyObject) GetLocation(DependencyObject)

Gets the value of the MapControl.Location XAML attached property from the specified child element of a MapControl. The location is the geographic location on the MapControl at which the MapControl.NormalizedAnchorPoint of the child element is positioned.

public : static Geopoint GetLocation(DependencyObject element)
public static Geopoint GetLocation(DependencyObject element)
Public Static Function GetLocation(element As DependencyObject) As Geopoint
Parameters
element
DependencyObject DependencyObject DependencyObject

The element from which to read the property value.

Returns

The value of the MapControl.Location XAML attached property on the specified child element of a MapControl.

See Also

GetLocationFromOffset(Point, AltitudeReferenceSystem, Geopoint) GetLocationFromOffset(Point, AltitudeReferenceSystem, Geopoint) GetLocationFromOffset(Point, AltitudeReferenceSystem, Geopoint)

Converts a point on the map to a geographic location by using the specified altitude reference system.

Note

This method is deprecated. Use the TryGetLocationFromOffset method instead.

public : void GetLocationFromOffset(Point offset, AltitudeReferenceSystem desiredReferenceSystem, Geopoint location)
public void GetLocationFromOffset(Point offset, AltitudeReferenceSystem desiredReferenceSystem, Geopoint location)
Public Function GetLocationFromOffset(offset As Point, desiredReferenceSystem As AltitudeReferenceSystem, location As Geopoint) As void
Parameters
offset
Point Point Point

A point on the map to convert to a geographic location.

desiredReferenceSystem
AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem

The altitude reference system of the geographic point. A value of Unspecified for the altitude reference system has the same effect as using the default GetLocationFromOffset(Windows.Foundation.Point offset, Windows.Devices.Geolocation.Geopoint location) overload.

location
Geopoint Geopoint Geopoint

When this method returns, contains the corresponding geographic location.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

Remarks

This method provides an instance of a Geopoint. That Geopoint contains a BasicGeoPosition. object. The desiredReferenceSystem parameter sets the Altitude field of that object.

This method will throw an exception if the point is invalid.

Note

An AltitudeReferenceSystem of Ellipsoid might not be supported.

GetLocationFromOffset(Point, Geopoint) GetLocationFromOffset(Point, Geopoint) GetLocationFromOffset(Point, Geopoint)

Converts a point on the map to a geographic location.

Note

This method is deprecated. Use the TryGetLocationFromOffset method instead.

public : void GetLocationFromOffset(Point offset, Geopoint location)
public void GetLocationFromOffset(Point offset, Geopoint location)
Public Function GetLocationFromOffset(offset As Point, location As Geopoint) As void
Parameters
offset
Point Point Point

A point on the map to convert to a geographic location.

location
Geopoint Geopoint Geopoint

When this method returns, contains the corresponding geographic location.

Remarks

This method will throw an exception if the point is invalid.

See Also

GetNormalizedAnchorPoint(DependencyObject) GetNormalizedAnchorPoint(DependencyObject) GetNormalizedAnchorPoint(DependencyObject)

Gets the value of the MapControl.NormalizedAnchorPoint XAML attached property from the specified child element of a MapControl. The anchor point is the point on the child element that is positioned at the point on the MapControl specified by the MapControl.Location attached property.

public : static Point GetNormalizedAnchorPoint(DependencyObject element)
public static Point GetNormalizedAnchorPoint(DependencyObject element)
Public Static Function GetNormalizedAnchorPoint(element As DependencyObject) As Point
Parameters
element
DependencyObject DependencyObject DependencyObject

The element from which to read the property value.

Returns

The value of the MapControl.NormalizedAnchorPoint XAML attached property on the specified child element of a MapControl.

See Also

GetOffsetFromLocation(Geopoint, Point) GetOffsetFromLocation(Geopoint, Point) GetOffsetFromLocation(Geopoint, Point)

Converts a geographic location to a point on the map.

public : void GetOffsetFromLocation(Geopoint location, Point offset)
public void GetOffsetFromLocation(Geopoint location, Point offset)
Public Function GetOffsetFromLocation(location As Geopoint, offset As Point) As void
Parameters
location
Geopoint Geopoint Geopoint

A geographic location to convert to a point on the map.

offset
Point Point Point

When this method returns, contains the corresponding point on the map.

Remarks

This method returns a valid point only when the geographic location appears within the map control view.

Compare the GetLocationFromOffset method.

See Also

GetTemplateChild(String) GetTemplateChild(String) GetTemplateChild(String)

Inherited from Control

GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Inherited from DependencyObject

GetVisibleRegion(MapVisibleRegionKind) GetVisibleRegion(MapVisibleRegionKind) GetVisibleRegion(MapVisibleRegionKind)

Gets the visible region of the map control.

public : Geopath GetVisibleRegion(MapVisibleRegionKind region)
public Geopath GetVisibleRegion(MapVisibleRegionKind region)
Public Function GetVisibleRegion(region As MapVisibleRegionKind) As Geopath
Parameters
Returns

The geopath indicating the visible region of the map control. The returned value can be null when a valid visible region cannot be calculated.

Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

GoToElementStateCore(String,Boolean) GoToElementStateCore(String,Boolean) GoToElementStateCore(String,Boolean)

Inherited from FrameworkElement

InvalidateArrange InvalidateArrange InvalidateArrange

Inherited from UIElement

InvalidateMeasure InvalidateMeasure InvalidateMeasure

Inherited from UIElement

IsLocationInView(Geopoint, Boolean) IsLocationInView(Geopoint, Boolean) IsLocationInView(Geopoint, Boolean)

Determines whether the specified geographic location is located in the portion of the map currently visible in the MapControl.

public : void IsLocationInView(Geopoint location, bool isInView)
public void IsLocationInView(Geopoint location, Boolean isInView)
Public Function IsLocationInView(location As Geopoint, isInView As Boolean) As void
Parameters
location
Geopoint Geopoint Geopoint

A geographic location.

isInView
bool Boolean Boolean

When this method returns, contains true if the specified geographic location is located in the portion of the map currently visible in the MapControl; otherwise, contains false.

See Also

Measure(Size) Measure(Size) Measure(Size)

Inherited from UIElement

MeasureOverride(Size) MeasureOverride(Size) MeasureOverride(Size)

Inherited from FrameworkElement

OnApplyTemplate OnApplyTemplate OnApplyTemplate

Inherited from FrameworkElement

OnCharacterReceived(CharacterReceivedRoutedEventArgs) OnCharacterReceived(CharacterReceivedRoutedEventArgs) OnCharacterReceived(CharacterReceivedRoutedEventArgs)

Inherited from Control

OnCreateAutomationPeer OnCreateAutomationPeer OnCreateAutomationPeer

Inherited from UIElement

OnDisconnectVisualChildren OnDisconnectVisualChildren OnDisconnectVisualChildren

Inherited from UIElement

OnDoubleTapped(DoubleTappedRoutedEventArgs) OnDoubleTapped(DoubleTappedRoutedEventArgs) OnDoubleTapped(DoubleTappedRoutedEventArgs)

Inherited from Control

OnDragEnter(DragEventArgs) OnDragEnter(DragEventArgs) OnDragEnter(DragEventArgs)

Inherited from Control

OnDragLeave(DragEventArgs) OnDragLeave(DragEventArgs) OnDragLeave(DragEventArgs)

Inherited from Control

OnDragOver(DragEventArgs) OnDragOver(DragEventArgs) OnDragOver(DragEventArgs)

Inherited from Control

OnDrop(DragEventArgs) OnDrop(DragEventArgs) OnDrop(DragEventArgs)

Inherited from Control

OnGotFocus(RoutedEventArgs) OnGotFocus(RoutedEventArgs) OnGotFocus(RoutedEventArgs)

Inherited from Control

OnHolding(HoldingRoutedEventArgs) OnHolding(HoldingRoutedEventArgs) OnHolding(HoldingRoutedEventArgs)

Inherited from Control

OnKeyDown(KeyRoutedEventArgs) OnKeyDown(KeyRoutedEventArgs) OnKeyDown(KeyRoutedEventArgs)

Inherited from Control

OnKeyUp(KeyRoutedEventArgs) OnKeyUp(KeyRoutedEventArgs) OnKeyUp(KeyRoutedEventArgs)

Inherited from Control

OnLostFocus(RoutedEventArgs) OnLostFocus(RoutedEventArgs) OnLostFocus(RoutedEventArgs)

Inherited from Control

OnManipulationCompleted(ManipulationCompletedRoutedEventArgs) OnManipulationCompleted(ManipulationCompletedRoutedEventArgs) OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

Inherited from Control

OnManipulationDelta(ManipulationDeltaRoutedEventArgs) OnManipulationDelta(ManipulationDeltaRoutedEventArgs) OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

Inherited from Control

OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs) OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs) OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

Inherited from Control

OnManipulationStarted(ManipulationStartedRoutedEventArgs) OnManipulationStarted(ManipulationStartedRoutedEventArgs) OnManipulationStarted(ManipulationStartedRoutedEventArgs)

Inherited from Control

OnManipulationStarting(ManipulationStartingRoutedEventArgs) OnManipulationStarting(ManipulationStartingRoutedEventArgs) OnManipulationStarting(ManipulationStartingRoutedEventArgs)

Inherited from Control

OnPointerCanceled(PointerRoutedEventArgs) OnPointerCanceled(PointerRoutedEventArgs) OnPointerCanceled(PointerRoutedEventArgs)

Inherited from Control

OnPointerCaptureLost(PointerRoutedEventArgs) OnPointerCaptureLost(PointerRoutedEventArgs) OnPointerCaptureLost(PointerRoutedEventArgs)

Inherited from Control

OnPointerEntered(PointerRoutedEventArgs) OnPointerEntered(PointerRoutedEventArgs) OnPointerEntered(PointerRoutedEventArgs)

Inherited from Control

OnPointerExited(PointerRoutedEventArgs) OnPointerExited(PointerRoutedEventArgs) OnPointerExited(PointerRoutedEventArgs)

Inherited from Control

OnPointerMoved(PointerRoutedEventArgs) OnPointerMoved(PointerRoutedEventArgs) OnPointerMoved(PointerRoutedEventArgs)

Inherited from Control

OnPointerPressed(PointerRoutedEventArgs) OnPointerPressed(PointerRoutedEventArgs) OnPointerPressed(PointerRoutedEventArgs)

Inherited from Control

OnPointerReleased(PointerRoutedEventArgs) OnPointerReleased(PointerRoutedEventArgs) OnPointerReleased(PointerRoutedEventArgs)

Inherited from Control

OnPointerWheelChanged(PointerRoutedEventArgs) OnPointerWheelChanged(PointerRoutedEventArgs) OnPointerWheelChanged(PointerRoutedEventArgs)

Inherited from Control

OnPreviewKeyDown(KeyRoutedEventArgs) OnPreviewKeyDown(KeyRoutedEventArgs) OnPreviewKeyDown(KeyRoutedEventArgs)

Inherited from Control

OnPreviewKeyUp(KeyRoutedEventArgs) OnPreviewKeyUp(KeyRoutedEventArgs) OnPreviewKeyUp(KeyRoutedEventArgs)

Inherited from Control

OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Inherited from UIElement

OnRightTapped(RightTappedRoutedEventArgs) OnRightTapped(RightTappedRoutedEventArgs) OnRightTapped(RightTappedRoutedEventArgs)

Inherited from Control

OnTapped(TappedRoutedEventArgs) OnTapped(TappedRoutedEventArgs) OnTapped(TappedRoutedEventArgs)

Inherited from Control

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Inherited from DependencyObject

RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback)

Inherited from DependencyObject

ReleasePointerCapture(Pointer) ReleasePointerCapture(Pointer) ReleasePointerCapture(Pointer)

Inherited from UIElement

ReleasePointerCaptures ReleasePointerCaptures ReleasePointerCaptures

Inherited from UIElement

RemoveFocusEngagement RemoveFocusEngagement RemoveFocusEngagement

Inherited from Control

RemoveHandler(RoutedEvent,Object) RemoveHandler(RoutedEvent,Object) RemoveHandler(RoutedEvent,Object)

Inherited from UIElement

SetBinding(DependencyProperty,BindingBase) SetBinding(DependencyProperty,BindingBase) SetBinding(DependencyProperty,BindingBase)

Inherited from FrameworkElement

SetIsTemplateFocusTarget(FrameworkElement,Boolean) SetIsTemplateFocusTarget(FrameworkElement,Boolean) SetIsTemplateFocusTarget(FrameworkElement,Boolean)

Inherited from Control

SetIsTemplateKeyTipTarget(DependencyObject,Boolean) SetIsTemplateKeyTipTarget(DependencyObject,Boolean) SetIsTemplateKeyTipTarget(DependencyObject,Boolean)

Inherited from Control

SetLocation(DependencyObject, Geopoint) SetLocation(DependencyObject, Geopoint) SetLocation(DependencyObject, Geopoint)

Sets the value of the MapControl.Location XAML attached property on the specified child element of a MapControl. The location is the geographic location on the MapControl at which the MapControl.NormalizedAnchorPoint of the child element is positioned.

public : static void SetLocation(DependencyObject element, Geopoint value)
public static void SetLocation(DependencyObject element, Geopoint value)
Public Static Function SetLocation(element As DependencyObject, value As Geopoint) As void
Parameters
element
DependencyObject DependencyObject DependencyObject

The element on which to set the property value.

value
Geopoint Geopoint Geopoint

The value of the MapControl.Location XAML attached property to set on the specified child element of a MapControl.

See Also

SetNormalizedAnchorPoint(DependencyObject, Point) SetNormalizedAnchorPoint(DependencyObject, Point) SetNormalizedAnchorPoint(DependencyObject, Point)

Sets the value of the MapControl.NormalizedAnchorPoint XAML attached property on the specified child element of a MapControl. The anchor point is the point on the child element that is positioned at the point on the MapControl specified by the MapControl.Location attached property.

public : static void SetNormalizedAnchorPoint(DependencyObject element, Point value)
public static void SetNormalizedAnchorPoint(DependencyObject element, Point value)
Public Static Function SetNormalizedAnchorPoint(element As DependencyObject, value As Point) As void
Parameters
element
DependencyObject DependencyObject DependencyObject

The element on which to set the property value.

value
Point Point Point

The value of the MapControl.NormalizedAnchorPoint XAML attached property to set on the specified child element of a MapControl.

See Also

SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object)

Inherited from DependencyObject

StartBringIntoView StartBringIntoView StartBringIntoView

Inherited from UIElement

StartBringIntoView(BringIntoViewOptions) StartBringIntoView(BringIntoViewOptions) StartBringIntoView(BringIntoViewOptions)

Inherited from UIElement

StartContinuousPan(Double, Double) StartContinuousPan(Double, Double) StartContinuousPan(Double, Double)

Starts an asynchronous operation to pan the map continuously from its current position.

public : void StartContinuousPan(double horizontalPixelsPerSecond, double verticalPixelsPerSecond)
public void StartContinuousPan(Double horizontalPixelsPerSecond, Double verticalPixelsPerSecond)
Public Function StartContinuousPan(horizontalPixelsPerSecond As Double, verticalPixelsPerSecond As Double) As void
Parameters
horizontalPixelsPerSecond
double Double Double

The pixels per second to pan horizontally.

verticalPixelsPerSecond
double Double Double

The pixels per second to pan vertically.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

StartContinuousRotate(Double) StartContinuousRotate(Double) StartContinuousRotate(Double)

Starts an asynchronous operation to rotate the map's camera continuously from its current position.

public : void StartContinuousRotate(double rateInDegreesPerSecond)
public void StartContinuousRotate(Double rateInDegreesPerSecond)
Public Function StartContinuousRotate(rateInDegreesPerSecond As Double) As void
Parameters
rateInDegreesPerSecond
double Double Double

The degrees that the map's camera rotates per second in a horizontal clockwise direction.

Remarks

Heading values greater than 360 degrees are normalized to their equivalent 0-360 degree value.

StartContinuousTilt(Double) StartContinuousTilt(Double) StartContinuousTilt(Double)

Starts an asynchronous operation to tilt the map's camera continuously from its current position.

public : void StartContinuousTilt(double rateInDegreesPerSecond)
public void StartContinuousTilt(Double rateInDegreesPerSecond)
Public Function StartContinuousTilt(rateInDegreesPerSecond As Double) As void
Parameters
rateInDegreesPerSecond
double Double Double

The degrees of Pitch that the map's camera tilts down to the ground per second.

Remarks

For more information about tilt, see the remarks section of the MapCamera(Geopoint, Double, Double, Double, Double) overload.

StartContinuousZoom(Double) StartContinuousZoom(Double) StartContinuousZoom(Double)

Starts an asynchronous operation to zoom in continuously until the map's maximum ZoomLevel is reached.

public : void StartContinuousZoom(double rateOfChangePerSecond)
public void StartContinuousZoom(Double rateOfChangePerSecond)
Public Function StartContinuousZoom(rateOfChangePerSecond As Double) As void
Parameters
rateOfChangePerSecond
double Double Double

The change in ZoomLevel per second.

Remarks

The maximum and minimum values of ZoomLevel depend on the type of map view: 2D, 3D, or Streetside.

Property2D range3D rangeStreetside range
ZoomLevel1-201-2024-26

When leaving a Streetside view, the map returns to the previous view settings. The Streetside ZoomLevel is not maintained outside of the Streetside experience.

StartDragAsync(PointerPoint) StartDragAsync(PointerPoint) StartDragAsync(PointerPoint)

Inherited from UIElement

StopContinuousPan() StopContinuousPan() StopContinuousPan()

Stops an asynchronous operation to pan the map continuously from its current position.

public : void StopContinuousPan()
public void StopContinuousPan()
Public Function StopContinuousPan() As void
Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

StopContinuousRotate() StopContinuousRotate() StopContinuousRotate()

Stops an asynchronous operation to rotate the map's camera continuously from its current position.

public : void StopContinuousRotate()
public void StopContinuousRotate()
Public Function StopContinuousRotate() As void

StopContinuousTilt() StopContinuousTilt() StopContinuousTilt()

Stops an asynchronous operation to tilt the map's camera continuously from its current position.

public : void StopContinuousTilt()
public void StopContinuousTilt()
Public Function StopContinuousTilt() As void

StopContinuousZoom() StopContinuousZoom() StopContinuousZoom()

Stops an asynchronous operation to zoom in continuously until the map's maximum ZoomLevel is reached.

public : void StopContinuousZoom()
public void StopContinuousZoom()
Public Function StopContinuousZoom() As void

TransformToVisual(UIElement) TransformToVisual(UIElement) TransformToVisual(UIElement)

Inherited from UIElement

TryGetLocationFromOffset(Point, AltitudeReferenceSystem, Geopoint) TryGetLocationFromOffset(Point, AltitudeReferenceSystem, Geopoint) TryGetLocationFromOffset(Point, AltitudeReferenceSystem, Geopoint)

Converts a point on the map to a geographic location by using the specified altitude reference system.

public : Platform::Boolean TryGetLocationFromOffset(Point offset, AltitudeReferenceSystem desiredReferenceSystem, Geopoint location)
public bool TryGetLocationFromOffset(Point offset, AltitudeReferenceSystem desiredReferenceSystem, Geopoint location)
Public Function TryGetLocationFromOffset(offset As Point, desiredReferenceSystem As AltitudeReferenceSystem, location As Geopoint) As bool
Parameters
offset
Point Point Point

A point on the map to convert to a geographic location.

desiredReferenceSystem
AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem

The altitude reference system of the geographic point. A value of Unspecified for the altitude reference system has the same effect as using the default TryGetLocationFromOffset(Windows.Foundation.Point offset, Windows.Devices.Geolocation.Geopoint location) overload.

location
Geopoint Geopoint Geopoint

When this method returns, contains the corresponding geographic location.

Returns
Platform::Boolean bool bool

Returns true if the location is invalid; otherwise, false.

Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

Remarks

Use this method instead of the GetLocationFromOffset method. The GetLocationFromOffset method has been deprecated.

TryGetLocationFromOffset(Point, Geopoint) TryGetLocationFromOffset(Point, Geopoint) TryGetLocationFromOffset(Point, Geopoint)

Converts a point on the map to a geographic location.

public : Platform::Boolean TryGetLocationFromOffset(Point offset, Geopoint location)
public bool TryGetLocationFromOffset(Point offset, Geopoint location)
Public Function TryGetLocationFromOffset(offset As Point, location As Geopoint) As bool
Parameters
offset
Point Point Point

A point on the map to convert to a geographic location.

location
Geopoint Geopoint Geopoint

When this method returns, contains the corresponding geographic location.

Returns
Platform::Boolean bool bool

Returns true if the location is invalid; otherwise, false.

Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

Remarks

Use this method instead of the GetLocationFromOffset method. The GetLocationFromOffset method has been deprecated.

TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Inherited from UIElement

TryPanAsync(Double, Double) TryPanAsync(Double, Double) TryPanAsync(Double, Double)

Starts an asynchronous operation to pan the map from its current position.

public : IAsyncOperation<Platform::Boolean> TryPanAsync(double horizontalPixels, double verticalPixels)
public IAsyncOperation<bool> TryPanAsync(Double horizontalPixels, Double verticalPixels)
Public Function TryPanAsync(horizontalPixels As Double, verticalPixels As Double) As IAsyncOperation( Of bool )
Parameters
horizontalPixels
double Double Double

The pixels to pan horizontally.

verticalPixels
double Double Double

The pixels to pan vertically.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

Contains the results of the operation: true if the operation completed successfully; otherwise, false.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

TryPanToAsync(Geopoint) TryPanToAsync(Geopoint) TryPanToAsync(Geopoint)

Starts an asynchronous operation to pan the map to a specific location.

public : IAsyncOperation<Platform::Boolean> TryPanToAsync(Geopoint location)
public IAsyncOperation<bool> TryPanToAsync(Geopoint location)
Public Function TryPanToAsync(location As Geopoint) As IAsyncOperation( Of bool )
Parameters
location
Geopoint Geopoint Geopoint

The coordinates of a geographic location to which you want to pan the map.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

Contains the results of the operation: true if the operation completed successfully; otherwise, false.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

TryRotateAsync(Double) TryRotateAsync(Double) TryRotateAsync(Double)

Starts an asynchronous operation to rotate the map's camera from its current position.

public : IAsyncOperation<Platform::Boolean> TryRotateAsync(double degrees)
public IAsyncOperation<bool> TryRotateAsync(Double degrees)
Public Function TryRotateAsync(degrees As Double) As IAsyncOperation( Of bool )
Parameters
degrees
double Double Double

The degrees that the map's camera rotates in a horizontal clockwise direction.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

Contains the results of the operation: true if the operation completed successfully; otherwise, false.

Remarks

Consider this method when you want to replace the default UI control with your own.

Heading values greater than 360 degrees are normalized to their equivalent 0-360 degree value.

TryRotateToAsync(Double) TryRotateToAsync(Double) TryRotateToAsync(Double)

Starts an asynchronous operation to rotate the map's camera to a specific orientation.

public : IAsyncOperation<Platform::Boolean> TryRotateToAsync(double angleInDegrees)
public IAsyncOperation<bool> TryRotateToAsync(Double angleInDegrees)
Public Function TryRotateToAsync(angleInDegrees As Double) As IAsyncOperation( Of bool )
Parameters
angleInDegrees
double Double Double

The final Heading of the map's camera, in degrees.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

Contains the results of the operation: true if the operation completed successfully; otherwise, false.

Remarks

See the remarks section of the TryRotateAsync method.

TrySetSceneAsync(MapScene) TrySetSceneAsync(MapScene) TrySetSceneAsync(MapScene)

Sets the scene of the map displayed in the MapControl using the specified scene.

public : IAsyncOperation<Platform::Boolean> TrySetSceneAsync(MapScene scene)
public IAsyncOperation<bool> TrySetSceneAsync(MapScene scene)
Public Function TrySetSceneAsync(scene As MapScene) As IAsyncOperation( Of bool )
Parameters
scene
MapScene MapScene MapScene

Defines the item or area to appear in the map.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

true if the asynchronous operation succeeded; otherwise, false.

See Also

TrySetSceneAsync(MapScene, MapAnimationKind) TrySetSceneAsync(MapScene, MapAnimationKind) TrySetSceneAsync(MapScene, MapAnimationKind)

Sets the scene of the map displayed in the MapControl using the specified scene and animation.

public : IAsyncOperation<Platform::Boolean> TrySetSceneAsync(MapScene scene, MapAnimationKind animationKind)
public IAsyncOperation<bool> TrySetSceneAsync(MapScene scene, MapAnimationKind animationKind)
Public Function TrySetSceneAsync(scene As MapScene, animationKind As MapAnimationKind) As IAsyncOperation( Of bool )
Parameters
scene
MapScene MapScene MapScene

Defines the item or area to appear in the map.

animationKind
MapAnimationKind MapAnimationKind MapAnimationKind

Specifies the animation to use when you change the scene of the map.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

true if the asynchronous operation succeeded; otherwise, false.

See Also

TrySetViewAsync(Geopoint) TrySetViewAsync(Geopoint) TrySetViewAsync(Geopoint)

TrySetViewAsync(Geopoint, IReference) TrySetViewAsync(Geopoint, IReference) TrySetViewAsync(Geopoint, IReference)

Sets the view of the map displayed in the MapControl using the specified center and zoom level.

public : IAsyncOperation<Platform::Boolean> TrySetViewAsync(Geopoint center, IReference<double> zoomLevel)
public IAsyncOperation<bool> TrySetViewAsync(Geopoint center, Nullable<Double> zoomLevel)
Public Function TrySetViewAsync(center As Geopoint, zoomLevel As Nullable<Double>) As IAsyncOperation( Of bool )
Parameters
center
Geopoint Geopoint Geopoint

The center to use in the view. For more info, see the Center property.

zoomLevel
IReference<double> Nullable<Double> Nullable<Double>

The zoom level to use in the view. For more info, see the ZoomLevel property.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

true if the asynchronous operation succeeded; otherwise, false.

Remarks

The maximum and minimum values of ZoomLevel depend on the type of map view: 2D, 3D, or Streetside.

Property2D range3D rangeStreetside range
ZoomLevel1-201-2024-26

When leaving a Streetside view, the map returns to the previous view settings. The Streetside ZoomLevel is not maintained outside of the Streetside experience.

See Also

TrySetViewAsync(Geopoint, IReference, IReference, IReference) TrySetViewAsync(Geopoint, IReference, IReference, IReference) TrySetViewAsync(Geopoint, IReference, IReference, IReference)

Sets the view of the map displayed in the MapControl using the specified center, zoom level, heading, and pitch.

public : IAsyncOperation<Platform::Boolean> TrySetViewAsync(Geopoint center, IReference<double> zoomLevel, IReference<double> heading, IReference<double> desiredPitch)
public IAsyncOperation<bool> TrySetViewAsync(Geopoint center, Nullable<Double> zoomLevel, Nullable<Double> heading, Nullable<Double> desiredPitch)
Public Function TrySetViewAsync(center As Geopoint, zoomLevel As Nullable<Double>, heading As Nullable<Double>, desiredPitch As Nullable<Double>) As IAsyncOperation( Of bool )
Parameters
center
Geopoint Geopoint Geopoint

The center to use in the view. For more info, see the Center property.

zoomLevel
IReference<double> Nullable<Double> Nullable<Double>

The zoom level to use in the view. For more info, see the ZoomLevel property.

heading
IReference<double> Nullable<Double> Nullable<Double>

The heading to use in the view. For more info, see the Heading property.

desiredPitch
IReference<double> Nullable<Double> Nullable<Double>

The pitch to use in the view. For more info, see the DesiredPitch property.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

true if the asynchronous operation succeeded; otherwise, false.

Remarks

The maximum and minimum values of pitch/tilt depend on the type of map view: 2D, 3D, or Streetside.

Property2D range3D rangeStreetside range
pitch/tilt0-750-900-180
ZoomLevel1-201-2024-26

For more information, see the TrySetViewAsync(Geopoint, IReference(Double), IReference(Double), IReference(Double), MapAnimationKind) overload.

Heading values greater than 360 degrees are normalized to their equivalent 0-360 degree value.

See Also

TrySetViewAsync(Geopoint, IReference, IReference, IReference, MapAnimationKind) TrySetViewAsync(Geopoint, IReference, IReference, IReference, MapAnimationKind) TrySetViewAsync(Geopoint, IReference, IReference, IReference, MapAnimationKind)

Sets the view of the map displayed in the MapControl using the specified center, zoom level, heading, and pitch. The view change uses the specified animation.

public : IAsyncOperation<Platform::Boolean> TrySetViewAsync(Geopoint center, IReference<double> zoomLevel, IReference<double> heading, IReference<double> desiredPitch, MapAnimationKind animation)
public IAsyncOperation<bool> TrySetViewAsync(Geopoint center, Nullable<Double> zoomLevel, Nullable<Double> heading, Nullable<Double> desiredPitch, MapAnimationKind animation)
Public Function TrySetViewAsync(center As Geopoint, zoomLevel As Nullable<Double>, heading As Nullable<Double>, desiredPitch As Nullable<Double>, animation As MapAnimationKind) As IAsyncOperation( Of bool )
Parameters
center
Geopoint Geopoint Geopoint

The center to use in the view. For more info, see the Center property.

zoomLevel
IReference<double> Nullable<Double> Nullable<Double>

The zoom level to use in the view. For more info, see the ZoomLevel property.

heading
IReference<double> Nullable<Double> Nullable<Double>

The heading to use in the view. For more info, see the Heading property.

desiredPitch
IReference<double> Nullable<Double> Nullable<Double>

The pitch to use in the view. For more info, see the DesiredPitch property.

animation
MapAnimationKind MapAnimationKind MapAnimationKind

The animation to use when changing the view. For more info, see MapAnimationKind.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

true if the asynchronous operation succeeded; otherwise, false.

Remarks

The valid range of pitch and zoom level differs between 2D, 3D, and Streetside map views. When switching from 3D to 2D for example, values that are acceptable in the current view may be out of range in the next view. If that’s the case, the current pitch value will be truncated to the nearest acceptable value in the next view.

When leaving a Streetside view, the map returns to the previous view settings. The Streetside pitch is not maintained outside of the Streetside experience.

The maximum and minimum values of pitch/tilt depend on the type of map view: 2D, 3D, or Streetside.

Property2D range3D rangeStreetside range
pitch/tilt0-750-900-180
ZoomLevel1-201-2024-26

Heading values greater than 360 degrees are normalized to their equivalent 0-360 degree value.

See Also

TrySetViewBoundsAsync(GeoboundingBox, IReference, MapAnimationKind) TrySetViewBoundsAsync(GeoboundingBox, IReference, MapAnimationKind) TrySetViewBoundsAsync(GeoboundingBox, IReference, MapAnimationKind)

Sets the view of the map displayed in the MapControl to the contents of the specified GeoboundingBox with the specified margin. The view change uses the specified animation.

public : IAsyncOperation<Platform::Boolean> TrySetViewBoundsAsync(GeoboundingBox bounds, IReference<Thickness> margin, MapAnimationKind animation)
public IAsyncOperation<bool> TrySetViewBoundsAsync(GeoboundingBox bounds, Nullable<Thickness> margin, MapAnimationKind animation)
Public Function TrySetViewBoundsAsync(bounds As GeoboundingBox, margin As Nullable<Thickness>, animation As MapAnimationKind) As IAsyncOperation( Of bool )
Parameters
bounds
GeoboundingBox GeoboundingBox GeoboundingBox

The geographic area to display in the view.

margin
IReference<Thickness> Nullable<Thickness> Nullable<Thickness>

The margin to use in the view.

animation
MapAnimationKind MapAnimationKind MapAnimationKind

The animation to use when changing the view. For more info, see MapAnimationKind.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

true if the asynchronous operation succeeded; otherwise, false.

Remarks

If the area specified by the GeoboundingBox doesn't fill the MapControl, the control also displays the surrounding area outside the GeoboundingBox.

See Also

TryStartDirectManipulation(Pointer) TryStartDirectManipulation(Pointer) TryStartDirectManipulation(Pointer)

Inherited from UIElement

TryTiltAsync(Double) TryTiltAsync(Double) TryTiltAsync(Double)

Starts an asynchronous operation to tilt the map's camera from its current position.

public : IAsyncOperation<Platform::Boolean> TryTiltAsync(double degrees)
public IAsyncOperation<bool> TryTiltAsync(Double degrees)
Public Function TryTiltAsync(degrees As Double) As IAsyncOperation( Of bool )
Parameters
degrees
double Double Double

The degrees of Pitch that the map's camera tilts down to the ground.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

Contains the results of the operation: true if the operation completed successfully; otherwise, false.

Remarks

Consider this method when you want to replace the default UI control with your own.

The valid range of tilt differs between 2D, 3D, and Streetside map views. When switching from 3D to 2D for example, values that are acceptable in the current view may be out of range in the next view. If that’s the case, the current tilt value will be truncated to the nearest acceptable value in the next view.

When leaving a Streetside view, the map returns to the previous view settings. The Streetside pitch is not maintained outside of the Streetside experience.

The maximum and minimum values of pitch/tilt depend on the type of map view: 2D, 3D, or Streetside.

Property2D range3D rangeStreetside range
pitch/tilt0-750-900-180

TryTiltToAsync(Double) TryTiltToAsync(Double) TryTiltToAsync(Double)

Starts an asynchronous operation to tilt the map's camera to a specific orientation.

public : IAsyncOperation<Platform::Boolean> TryTiltToAsync(double angleInDegrees)
public IAsyncOperation<bool> TryTiltToAsync(Double angleInDegrees)
Public Function TryTiltToAsync(angleInDegrees As Double) As IAsyncOperation( Of bool )
Parameters
angleInDegrees
double Double Double

The final Pitch of the map's camera in degrees.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

Contains the results of the operation: true if the operation completed successfully; otherwise, false.

Remarks

See the remarks section of the TryTiltAsync method.

TryZoomInAsync() TryZoomInAsync() TryZoomInAsync()

Starts an asynchronous operation to zoom in, increasing the map's ZoomLevel by one.

public : IAsyncOperation<Platform::Boolean> TryZoomInAsync()
public IAsyncOperation<bool> TryZoomInAsync()
Public Function TryZoomInAsync() As IAsyncOperation( Of bool )
Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

Contains the results of the operation: true if the operation completed successfully; otherwise, false.

Remarks

Warning

We don't recommend changing ZoomLevel with 3D views. When the MapControl's view is not looking "straight-down," changes in ZoomLevel can lead to unpredictable behavior.

ZoomLevel is intended for 2D views. To implement a "zoom" effect with 3D views, use the MapControl's TrySetSceneAsync method to move the camera closer. Start by setting a closer Location on a MapCamera object. Next, create a new MapScene by passing that MapCamera to CreateFromCamera. Finally, initiate the zoom by passing the new MapScene to TrySetSceneAsync. You can zoom in immediately or specify MapAnimationKind to create an animated "fly in".

The maximum and minimum values of ZoomLevel depend on the type of map view: 2D, 3D, or Streetside.

Property2D range3D rangeStreetside range
ZoomLevel1-201-2024-26

When leaving a Streetside view, the map returns to the previous view settings. The Streetside ZoomLevel is not maintained outside of the Streetside experience.

Consider this method when you want to replace the default UI control with your own.

TryZoomOutAsync() TryZoomOutAsync() TryZoomOutAsync()

Starts an asynchronous operation to zoom out, decreasing the map's ZoomLevel by one.

public : IAsyncOperation<Platform::Boolean> TryZoomOutAsync()
public IAsyncOperation<bool> TryZoomOutAsync()
Public Function TryZoomOutAsync() As IAsyncOperation( Of bool )
Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

Contains the results of the operation: true if the operation completed successfully; otherwise, false.

Remarks

See the remarks section of the TryZoomInAsync method.

TryZoomToAsync(Double) TryZoomToAsync(Double) TryZoomToAsync(Double)

Starts an asynchronous operation to zoom the map to a specific ZoomLevel.

public : IAsyncOperation<Platform::Boolean> TryZoomToAsync(double zoomLevel)
public IAsyncOperation<bool> TryZoomToAsync(Double zoomLevel)
Public Function TryZoomToAsync(zoomLevel As Double) As IAsyncOperation( Of bool )
Parameters
zoomLevel
double Double Double

The final zoom level of the map, between 1 and 20.

Returns
IAsyncOperation<Platform::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

Contains the results of the operation: true if the operation completed successfully; otherwise, false.

Remarks

See the remarks section of the TryZoomInAsync method.

UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64)

Inherited from DependencyObject

UpdateLayout UpdateLayout UpdateLayout

Inherited from UIElement

Events

AccessKeyDisplayDismissed AccessKeyDisplayDismissed AccessKeyDisplayDismissed

Inherited from UIElement

AccessKeyDisplayRequested AccessKeyDisplayRequested AccessKeyDisplayRequested

Inherited from UIElement

AccessKeyInvoked AccessKeyInvoked AccessKeyInvoked

Inherited from UIElement

ActualCameraChanged ActualCameraChanged ActualCameraChanged

Occurs when the current position of the map's camera has changed.

public : event TypedEventHandler ActualCameraChanged<MapControl, MapActualCameraChangedEventArgs>
public event TypedEventHandler ActualCameraChanged<MapControl, MapActualCameraChangedEventArgs>
Public Event TypedEventHandler ActualCameraChanged( Of ( Of MapControl ), ( Of MapActualCameraChangedEventArgs ))

Remarks

During an animation of the map, the ActualCamera defines the current position of the map's camera and TargetCamera defines the final position of the camera.

ActualCameraChanging ActualCameraChanging ActualCameraChanging

Occurs when the current position of the map's camera changes.

public : event TypedEventHandler ActualCameraChanging<MapControl, MapActualCameraChangingEventArgs>
public event TypedEventHandler ActualCameraChanging<MapControl, MapActualCameraChangingEventArgs>
Public Event TypedEventHandler ActualCameraChanging( Of ( Of MapControl ), ( Of MapActualCameraChangingEventArgs ))

Remarks

During an animation of the map, the ActualCamera defines the current position of the map's camera and TargetCamera defines the final position of the camera.

ActualThemeChanged ActualThemeChanged ActualThemeChanged

Inherited from FrameworkElement

CenterChanged CenterChanged CenterChanged

Occurs when the value of the Center property of the MapControl changes.

public : event TypedEventHandler CenterChanged<MapControl, object>
public event TypedEventHandler CenterChanged<MapControl, object>
Public Event TypedEventHandler CenterChanged( Of ( Of MapControl ), ( Of object ))
See Also

CharacterReceived CharacterReceived CharacterReceived

Inherited from UIElement

ContextCanceled ContextCanceled ContextCanceled

Inherited from UIElement

ContextRequested ContextRequested ContextRequested

Inherited from UIElement

CustomExperienceChanged CustomExperienceChanged CustomExperienceChanged

Occurs when the custom experience of the MapControl changes.

public : event TypedEventHandler CustomExperienceChanged<MapControl, MapCustomExperienceChangedEventArgs>
public event TypedEventHandler CustomExperienceChanged<MapControl, MapCustomExperienceChangedEventArgs>
Public Event TypedEventHandler CustomExperienceChanged( Of ( Of MapControl ), ( Of MapCustomExperienceChangedEventArgs ))

Remarks

Custom experiences change the way maps appear in the MapControl. For example, the StreetsideExperience changes the perspective of the map to appear as though you were viewing a location from the street level. Entering or existing a street-level view will trigger the CustomExperienceChanged event.

DataContextChanged DataContextChanged DataContextChanged

Inherited from FrameworkElement

DoubleTapped DoubleTapped DoubleTapped

Inherited from UIElement

DragEnter DragEnter DragEnter

Inherited from UIElement

DragLeave DragLeave DragLeave

Inherited from UIElement

DragOver DragOver DragOver

Inherited from UIElement

DragStarting DragStarting DragStarting

Inherited from UIElement

Drop Drop Drop

Inherited from UIElement

DropCompleted DropCompleted DropCompleted

Inherited from UIElement

FocusDisengaged FocusDisengaged FocusDisengaged

Inherited from Control

FocusEngaged FocusEngaged FocusEngaged

Inherited from Control

GettingFocus GettingFocus GettingFocus

Inherited from UIElement

GotFocus GotFocus GotFocus

Inherited from UIElement

HeadingChanged HeadingChanged HeadingChanged

Occurs when the value of the Heading property of the MapControl changes.

public : event TypedEventHandler HeadingChanged<MapControl, object>
public event TypedEventHandler HeadingChanged<MapControl, object>
Public Event TypedEventHandler HeadingChanged( Of ( Of MapControl ), ( Of object ))
See Also

Holding Holding Holding

Inherited from UIElement

IsEnabledChanged IsEnabledChanged IsEnabledChanged

Inherited from Control

KeyDown KeyDown KeyDown

Inherited from UIElement

KeyUp KeyUp KeyUp

Inherited from UIElement

LayoutUpdated LayoutUpdated LayoutUpdated

Inherited from FrameworkElement

Loaded Loaded Loaded

Inherited from FrameworkElement

Loading Loading Loading

Inherited from FrameworkElement

LoadingStatusChanged LoadingStatusChanged LoadingStatusChanged

Occurs when the value of the LoadingStatus property of the MapControl changes.

public : event TypedEventHandler LoadingStatusChanged<MapControl, object>
public event TypedEventHandler LoadingStatusChanged<MapControl, object>
Public Event TypedEventHandler LoadingStatusChanged( Of ( Of MapControl ), ( Of object ))
See Also

LosingFocus LosingFocus LosingFocus

Inherited from UIElement

LostFocus LostFocus LostFocus

Inherited from UIElement

ManipulationCompleted ManipulationCompleted ManipulationCompleted

Inherited from UIElement

ManipulationDelta ManipulationDelta ManipulationDelta

Inherited from UIElement

ManipulationInertiaStarting ManipulationInertiaStarting ManipulationInertiaStarting

Inherited from UIElement

ManipulationStarted ManipulationStarted ManipulationStarted

Inherited from UIElement

ManipulationStarting ManipulationStarting ManipulationStarting

Inherited from UIElement

MapContextRequested MapContextRequested MapContextRequested

Occurs when the user has completed a context input gesture on a map, such as a right-click.

public : event TypedEventHandler MapContextRequested<MapControl, MapContextRequestedEventArgs>
public event TypedEventHandler MapContextRequested<MapControl, MapContextRequestedEventArgs>
Public Event TypedEventHandler MapContextRequested( Of ( Of MapControl ), ( Of MapContextRequestedEventArgs ))
Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

MapDoubleTapped MapDoubleTapped MapDoubleTapped

Occurs when the user double-taps the MapControl. An instance of MapInputEventArgs provides data for this event.

public : event TypedEventHandler MapDoubleTapped<MapControl, MapInputEventArgs>
public event TypedEventHandler MapDoubleTapped<MapControl, MapInputEventArgs>
Public Event TypedEventHandler MapDoubleTapped( Of ( Of MapControl ), ( Of MapInputEventArgs ))
See Also

MapElementClick MapElementClick MapElementClick

Occurs when the user taps or clicks a MapElement on the MapControl.

public : event TypedEventHandler MapElementClick<MapControl, MapElementClickEventArgs>
public event TypedEventHandler MapElementClick<MapControl, MapElementClickEventArgs>
Public Event TypedEventHandler MapElementClick( Of ( Of MapControl ), ( Of MapElementClickEventArgs ))

Remarks

Touch, mouse, and pen/stylus interactions are received, processed, and managed as pointers. Any of these devices and their interactions can produce a MapElementClick event. An instance of MapElementClickEventArgs provides data for this event.

MapElementPointerEntered MapElementPointerEntered MapElementPointerEntered

Occurs when a pointer moves into the bounding area of a MapElement on a MapControl.

public : event TypedEventHandler MapElementPointerEntered<MapControl, MapElementPointerEnteredEventArgs>
public event TypedEventHandler MapElementPointerEntered<MapControl, MapElementPointerEnteredEventArgs>
Public Event TypedEventHandler MapElementPointerEntered( Of ( Of MapControl ), ( Of MapElementPointerEnteredEventArgs ))

Remarks

Mouse interactions are received, processed, and managed as pointers. The MapElementPointerEntered event is triggered as the user moves their mouse over an element. An instance of MapElementPointerEnteredEventArgs provides data for this event.

MapElementPointerExited MapElementPointerExited MapElementPointerExited

Occurs when a pointer moves out of the bounding area of a MapElement on a MapControl.

public : event TypedEventHandler MapElementPointerExited<MapControl, MapElementPointerExitedEventArgs>
public event TypedEventHandler MapElementPointerExited<MapControl, MapElementPointerExitedEventArgs>
Public Event TypedEventHandler MapElementPointerExited( Of ( Of MapControl ), ( Of MapElementPointerExitedEventArgs ))

Remarks

Mouse interactions are received, processed, and managed as pointers. The MapElementPointerExited event is triggered as the user moves their mouse out from over an element. An instance of MapElementPointerExitedEventArgs provides data for this event.

MapHolding MapHolding MapHolding

Occurs when the user taps and holds on the MapControl. An instance of MapInputEventArgs provides data for this event.

public : event TypedEventHandler MapHolding<MapControl, MapInputEventArgs>
public event TypedEventHandler MapHolding<MapControl, MapInputEventArgs>
Public Event TypedEventHandler MapHolding( Of ( Of MapControl ), ( Of MapInputEventArgs ))
See Also

MapRightTapped MapRightTapped MapRightTapped

Occurs when the user presses-and-holds the MapControl or clicks on it using the right mouse button. An instance of MapRightTappedEventArgs provides data for this event.

public : event TypedEventHandler MapRightTapped<MapControl, MapRightTappedEventArgs>
public event TypedEventHandler MapRightTapped<MapControl, MapRightTappedEventArgs>
Public Event TypedEventHandler MapRightTapped( Of ( Of MapControl ), ( Of MapRightTappedEventArgs ))
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v2)

MapTapped MapTapped MapTapped

Occurs when the user taps the MapControl or clicks on it with the left mouse button. An instance of MapInputEventArgs provides data for this event.

public : event TypedEventHandler MapTapped<MapControl, MapInputEventArgs>
public event TypedEventHandler MapTapped<MapControl, MapInputEventArgs>
Public Event TypedEventHandler MapTapped( Of ( Of MapControl ), ( Of MapInputEventArgs ))
See Also

NoFocusCandidateFound NoFocusCandidateFound NoFocusCandidateFound

Inherited from UIElement

PitchChanged PitchChanged PitchChanged

Occurs when the value of the Pitch property of the MapControl changes.

public : event TypedEventHandler PitchChanged<MapControl, object>
public event TypedEventHandler PitchChanged<MapControl, object>
Public Event TypedEventHandler PitchChanged( Of ( Of MapControl ), ( Of object ))
See Also

PointerCanceled PointerCanceled PointerCanceled

Inherited from UIElement

PointerCaptureLost PointerCaptureLost PointerCaptureLost

Inherited from UIElement

PointerEntered PointerEntered PointerEntered

Inherited from UIElement

PointerExited PointerExited PointerExited

Inherited from UIElement

PointerMoved PointerMoved PointerMoved

Inherited from UIElement

PointerPressed PointerPressed PointerPressed

Inherited from UIElement

PointerReleased PointerReleased PointerReleased

Inherited from UIElement

PointerWheelChanged PointerWheelChanged PointerWheelChanged

Inherited from UIElement

PreviewKeyDown PreviewKeyDown PreviewKeyDown

Inherited from UIElement

PreviewKeyUp PreviewKeyUp PreviewKeyUp

Inherited from UIElement

ProcessKeyboardAccelerators ProcessKeyboardAccelerators ProcessKeyboardAccelerators

Inherited from UIElement

RightTapped RightTapped RightTapped

Inherited from UIElement

SizeChanged SizeChanged SizeChanged

Inherited from FrameworkElement

Tapped Tapped Tapped

Inherited from UIElement

TargetCameraChanged TargetCameraChanged TargetCameraChanged

Occurs when the final position of the map's camera has changed.

public : event TypedEventHandler TargetCameraChanged<MapControl, MapTargetCameraChangedEventArgs>
public event TypedEventHandler TargetCameraChanged<MapControl, MapTargetCameraChangedEventArgs>
Public Event TypedEventHandler TargetCameraChanged( Of ( Of MapControl ), ( Of MapTargetCameraChangedEventArgs ))

Remarks

During an animation of the map, the ActualCamera defines the current position of the map's camera and TargetCamera defines the final position of the camera.

TransformOriginChanged TransformOriginChanged TransformOriginChanged

Occurs when the value of the TransformOrigin property of the MapControl changes.

public : event TypedEventHandler TransformOriginChanged<MapControl, object>
public event TypedEventHandler TransformOriginChanged<MapControl, object>
Public Event TypedEventHandler TransformOriginChanged( Of ( Of MapControl ), ( Of object ))
See Also

Unloaded Unloaded Unloaded

Inherited from FrameworkElement

ZoomLevelChanged ZoomLevelChanged ZoomLevelChanged

Occurs when the value of the ZoomLevel property of the MapControl changes.

public : event TypedEventHandler ZoomLevelChanged<MapControl, object>
public event TypedEventHandler ZoomLevelChanged<MapControl, object>
Public Event TypedEventHandler ZoomLevelChanged( Of ( Of MapControl ), ( Of object ))
See Also

See Also