MapTileSource 类

定义

命名空间:

Windows.UI.Xaml.Controls.Maps

表示要覆盖在 MapControl 上的磁贴源。

/// [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)]
class MapTileSource : DependencyObject

[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)]
public class MapTileSource : DependencyObject

Public Class MapTileSource
Inherits DependencyObject

继承

Object IInspectable DependencyObject MapTileSource

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

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

示例

此示例覆盖地图上虚构 Web 服务中的图块。

// Create the bounding box in which the tiles are displayed.
// This example represents North America.
var northWestCorner =
               new BasicGeoposition() { Latitude = 48.38544, Longitude = -124.667360 };
var southEastCorner =
               new BasicGeoposition() { Latitude = 25.26954, Longitude = -80.30182 };
var boundingBox = new GeoboundingBox(northWestCorner, southEastCorner);

// Create an HTTP data source.
// This example retrieves tiles from a fictitious web service.
var myHttpDataSource = new HttpMapTileDataSource(
    "http://www.<web service name>.com/z={zoomlevel}&x={x}&y={y}");

// Create a tile source and add it to the Map control.
var myTileSource = new MapTileSource(myHttpDataSource);
myTileSource.Bounds = boundingBox;

myMap.TileSources.Add(myTileSource);

另一个示例对地图上虚构 Web 服务中的磁贴进行动画处理。 该代码创建一个 MapTileSource，其中 AutoPlay 属性显式设置为 true。

// Create an HTTP data source.
// This example retrieves tiles from a fictitious web service.
var myHttpDataSource = new HttpMapTileDataSource(
    "http://www.<web service name>.com/{x}/{y}/{zoomlevel}/{frame}.png");

// Create a tile source and add it to the Map control.
var myTileSource = new MapTileSource(myHttpDataSource);
myTileSource.AutoPlay = true;
myTileSource.FrameCount = 8;
myTileSource.FrameDuration = TimeSpan.FromSeconds(1);

myMap.TileSources.Add(myTileSource);

注解

还可以使用 MapTileSource 在 MapControl 上对磁贴进行动画处理。

版本历史记录

Windows 版本	SDK 版本	已添加值
1809	17763	AnimationState
1809	17763	自动播放
1809	17763	FrameCount
1809	17763	FrameDuration
1809	17763	暂停
1809	17763	播放
1809	17763	停止

构造函数

MapTileSource()	初始化 MapTileSource 类的新实例。
MapTileSource(MapTileDataSource)	使用指定的数据源初始化 MapTileSource 类的新实例。
MapTileSource(MapTileDataSource, MapZoomLevelRange)	使用指定的数据源和缩放级别范围初始化 MapTileSource 类的新实例。
MapTileSource(MapTileDataSource, MapZoomLevelRange, GeoboundingBox)	使用指定的数据源、缩放级别范围和边界矩形初始化 MapTileSource 类的新实例。
MapTileSource(MapTileDataSource, MapZoomLevelRange, GeoboundingBox, Int32)	使用指定的数据源、缩放级别范围、边界矩形和磁贴大小初始化 MapTileSource 类的新实例。

属性

AllowOverstretch	获取或设置一个值，该值指定是否在下载更高分辨率的磁贴时拉伸当前磁贴。
AllowOverstretchProperty	标识 AllowOverstretch 依赖属性。
AnimationState	获取要显示在 MapControl 中的此 MapTileSource 的动画状态。
AnimationStateProperty	标识 AnimationState 依赖属性。
AutoPlay	获取或设置一个值，该值指示将此 MapTileSource 添加到 MapControl 的 TileSources 属性时，地图图块是否会自动开始播放。
AutoPlayProperty	标识 AutoPlay 依赖属性。
Bounds	获取或设置要包含磁贴的矩形区域。
BoundsProperty	标识 Bounds 依赖属性。
DataSource	获取或设置磁贴的数据源。
DataSourceProperty	标识 DataSource 依赖属性。
Dispatcher	获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
FrameCount	获取或设置此 MapTileSource 动画中的帧数。
FrameCountProperty	标识 FrameCount 依赖属性。
FrameDuration	获取或设置此 MapTileSource 动画中每个帧的持续时间。
FrameDurationProperty	标识 FrameDuration 依赖属性。
IsFadingEnabled	获取或设置一个值，该值指示是否为磁贴启用淡化。
IsFadingEnabledProperty	标识 IsFadingEnabled 依赖属性。
IsRetryEnabled	获取或设置一个值，该值指示是否为磁贴启用重试。
IsRetryEnabledProperty	标识 IsRetryEnabled 依赖属性。
IsTransparencyEnabled	获取或设置一个值，该值指示是否为磁贴启用透明度。
IsTransparencyEnabledProperty	标识 IsTransparencyEnabled 依赖属性。
Layer	获取或设置包含图块的层。
LayerProperty	标识 Layer 依赖属性。
TilePixelSize	获取或设置磁贴的大小（以像素为单位）。
TilePixelSizeProperty	标识 TilePixelSize 依赖属性。
Visible	获取或设置一个值，该值指示 MapTileSource 是否可见。
VisibleProperty	标识 Visible 依赖属性。
ZIndex	获取或设置磁贴的 z 索引。
ZIndexProperty	标识 ZIndex 依赖属性。
ZoomLevelRange	获取或设置磁贴的最小和最大缩放级别。 仅当 MapControl 的 ZoomLevel 位于 ZoomLevelRange 内时，磁贴才可见。
ZoomLevelRangeProperty	标识 ZoomLevelRange 依赖属性。

方法

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

另请参阅

• DependencyObject
• 覆盖地图上的平铺图像