MapElement3D 类

定义

命名空间:

Windows.UI.Xaml.Controls.Maps

表示 MapControl 上显示的 3D 元素。

public ref class MapElement3D sealed : MapElement

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

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

Public NotInheritable Class MapElement3D
Inherits MapElement

继承

Object Platform::Object IInspectable DependencyObject MapElement MapElement3D

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Fall Creators Update (在 10.0.16299.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v5.0 中引入)

示例

本示例将一个 3D 元素放置在地图的中心。

map3dSphereStreamReference = RandomAccessStreamReference.CreateFromUri
   (new Uri("ms-appx:///Assets/trainengine.3mf"));    

 var myModel = await MapModel3D.CreateFrom3MFAsync(map3dSphereStreamReference,
     MapModel3DShadingOption.Smooth);

 var my3DElement = new MapElement3D();
 my3DElement.Location = myMap.Center;
 my3DElement.Model = myModel;

 var myLayer = new MapElementsLayer();
 myLayer.MapElements.Add(my3DElement);

 myMap.Layers.Add(myLayer);

注解

若要在地图控件上显示 3D 对象，请将 MapElement3D 添加到 MapElementsLayer 的 MapElements 集合。 然后，将 MapElementsLayer 添加到地图的 Layers 集合。

构造函数

MapElement3D()

创建 MapElement3D 实例。

属性

Dispatcher	获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
Heading	获取或设置以度为单位的 3D 地图元素的方向标题，其中 0 或 360 = 北，90 = 东，180 = 南，270 = 西。
HeadingProperty	获取依赖属性，该依赖属性为 Heading Windows 运行时 属性。
IsEnabled	指示用户是否可以与 MapElement 交互。 (继承自 MapElement)
Location	获取或设置 MapControl 上 MapElement3D 的地理位置。 .
LocationProperty	获取依赖属性，该依赖属性为 Location Windows 运行时 属性。
MapStyleSheetEntry	获取或设置要应用于此 MapElement 的地图样式表中的条目的名称。 (继承自 MapElement)
MapStyleSheetEntryState	获取或设置此 MapElement 的状态的名称。 如果样式表为该状态定义了样式，则该样式将应用于此元素。 在状态样式表中定义的值将替代 MapStyleSheetEntry 中定义的值。 (继承自 MapElement)
MapTabIndex	获取或设置一个值，该值确定当用户通过按 Tab 键浏览这些元素时 MapControl 元素接收焦点的顺序。 (继承自 MapElement)
Model	获取或设置表示 3D 对象的 3D 模型。
Pitch	获取或设置一个值，该值指示要倾斜 3D 地图元素的度数。 值为 0 表示向外看地平线，而值 -90 则直接向下看。 值 90 是直向上查找。 默认值为 0。
PitchProperty	获取依赖属性，该依赖属性为 Pitch Windows 运行时 属性。
Roll	获取或设置 3D 地图元素的滚动（以度为单位），其中 -90 向左倾斜，+90 向右倾斜。
RollProperty	获取后备 Roll Windows 运行时 属性的依赖属性。
Scale	要应用于 3D 地图元素的比例。
ScaleProperty	获取后备 Scale Windows 运行时 属性的依赖属性。
Tag	获取或设置可用于存储有关此对象的自定义信息的任意对象值。 (继承自 MapElement)
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)