MapIcon 类

定义

命名空间:

Windows.UI.Xaml.Controls.Maps

在 MapControl 上显示带有可选文本的图像，例如图钉。 使用默认映像或提供自定义映像。

public ref class MapIcon sealed : MapElement

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MapIcon final : MapElement

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MapIcon : MapElement

Public NotInheritable Class MapIcon
Inherits MapElement

继承

Object Platform::Object IInspectable DependencyObject MapElement MapIcon

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

通过将图钉、图像和形状添加到 MapElements 集合，在 MapControl 上显示它们。

• 使用 MapIcon 类显示带有可选文本 的图像 ，例如图钉。 保留默认映像或提供自定义映像。
• 定义并显示 MapPolygon 或 MapPolyline。 或者，若要在 MapControl 上显示 XAML 元素，请将其添加到其 Children 集合。

如果你不显式设置 Altitude 和 AltitudeReferenceSystem，MapIcon 将放置在图面。

提示

当你显示指向地图上特定位置的 MapIcon 图像时（例如，图钉或箭头），考虑将 NormalizedAnchorPoint 属性的值设置为图像上指针的大致位置。 如果你将 NormalizedAnchorPoint 的值保留为默认值 (0, 0)（表示图像的左上角），地图的 ZoomLevel 中的更改可能会导致图像指向其他位置。

构造函数

MapIcon()

初始化 MapIcon 类的新实例。

属性

CollisionBehaviorDesired	获取或设置 MapIcon 由于缩放级别而与其他地图特征相冲突时的行为。
CollisionBehaviorDesiredProperty	标识 CollisionBehaviorDesired 依赖属性。
Dispatcher	获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
Image	获取或设置 MapIcon 的图像。 提供可选的自定义映像以替换默认兴趣点 (POI) 映像。 支持以下流格式： PNG - 压缩的 PNG 格式流 JPG - 压缩的 JPG 格式流 SVG - 压缩的 SVG 格式的流 BMP - 未压缩的 BMP 格式流 原始 RGB 字节。 假定图像的大小为方形。 这仅适用于具有整型平方根长度的流。
IsEnabled	指示用户是否可以与 MapElement 交互。 (继承自 MapElement)
Location	获取或设置 MapControl 上 MapIcon 的地理位置。 该位置是 MapControl 上定位 MapIcon 的 NormalizedAnchorPoint 的地理位置。
LocationProperty	标识 Location 依赖属性。
MapStyleSheetEntry	获取或设置要应用于此 MapElement 的地图样式表中的条目的名称。 (继承自 MapElement)
MapStyleSheetEntryState	获取或设置此 MapElement 的状态的名称。 如果样式表为该状态定义了样式，则该样式将应用于此元素。 在状态样式表中定义的值将替代 MapStyleSheetEntry 中定义的值。 (继承自 MapElement)
MapTabIndex	获取或设置一个值，该值确定当用户通过按 Tab 键浏览这些元素时 MapControl 元素接收焦点的顺序。 (继承自 MapElement)
NormalizedAnchorPoint	获取或设置 MapIcon 的定位点。 定位点是 MapIcon 上的点，位于 Location 属性指定的 MapControl 上的点。
NormalizedAnchorPointProperty	标识 NormalizedAnchorPoint 依赖属性。
Tag	获取或设置可用于存储有关此对象的自定义信息的任意对象值。 (继承自 MapElement)
Title	获取或设置 MapIcon 的可选文本。
TitleProperty	标识 Title 依赖属性。
Visible	获取或设置一个值，该值指示 MapElement 在 MapControl 上是否可见。 (继承自 MapElement)
ZIndex	获取或设置 MapElement 的 z 索引。 Z 索引较高的 MapElement 显示在 z 索引较低的 MapElement 顶部。 (继承自 MapElement)

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册通知函数，用于侦听此 DependencyObject 实例上对特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• MapElement
• 使用 2D、3D 和街景视图显示地图