MapControl.TryZoomInAsync 方法

定义

命名空间:

Windows.UI.Xaml.Controls.Maps

启动异步操作以放大，使地图的 ZoomLevel 增加 1。

public:
 virtual IAsyncOperation<bool> ^ TryZoomInAsync() = TryZoomInAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<bool> TryZoomInAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<bool> TryZoomInAsync();

function tryZoomInAsync()

Public Function TryZoomInAsync () As IAsyncOperation(Of Boolean)

返回

IAsyncOperation<Boolean>

IAsyncOperation<bool>

包含操作的结果：如果操作成功完成，则为 true ;否则为 false。

属性

RemoteAsyncAttribute

注解

警告

不建议使用 3D 视图更改 ZoomLevel 。 当 MapControl 的视图不“直下”时， ZoomLevel 中的更改可能会导致不可预知的行为。

ZoomLevel 适用于 2D 视图。 若要使用 3D 视图实现“缩放”效果，请使用 MapControl 的 TrySetSceneAsync 方法将相机移近。 首先，在 MapCamera 对象上设置更靠近的位置。 接下来，通过将 MapCamera 传递到 CreateFromCamera 来创建新的 MapScene。 最后，通过将新的 MapScene 传递到 TrySetSceneAsync 来启动缩放。 可以立即放大或指定 MapAnimationKind 来创建动画“飞入”。

ZoomLevel 的最大值和最小值（由 MaxZoomLevel 和 MinZoomLevel 属性报告）取决于地图视图的类型：2D、3D 或 Streetside。

属性	2D 范围	3D 范围	街边范围
ZoomLevel	1-20	1-20	24-26

离开街景视图时，地图将返回到以前的视图设置。 街边 ZoomLevel 不在街边体验之外保留。

如果要将默认 UI 控件替换为自己的控件，请考虑此方法。