MapTileSource 类

定义

表示要覆盖在 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
属性

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 添加到 MapControlTileSources 属性时,地图图块是否会自动开始播放。

AutoPlayProperty

标识 AutoPlay 依赖属性。

Bounds

获取或设置要包含磁贴的矩形区域。

BoundsProperty

标识 Bounds 依赖属性。

DataSource

获取或设置磁贴的数据源。

DataSourceProperty

标识 DataSource 依赖属性。

Dispatcher

获取与此对象关联的 CoreDispatcherCoreDispatcher 表示可以访问 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

获取或设置磁贴的最小和最大缩放级别。 仅当 MapControlZoomLevel 位于 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)

适用于

另请参阅