MapControl.TryZoomInAsync 方法

定義

命名空間:

Windows.UI.Xaml.Controls.Maps

啟動非同步作業以放大，將地圖的 ZoomLevel 增加一個。

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物件上設定更接近的 Location。 接下來，將MapCamera傳遞至CreateFromCamera，以建立新的MapScene。 最後，將新的 MapScene 傳遞至 TrySetSceneAsync來起始縮放。 您可以立即放大，或指定 MapAnimationKind 來建立動畫的「飛入」。

ZoomLevel的最大值和最小值是由MaxZoomLevel和MinZoomLevel屬性所報告，取決於地圖檢視的類型：2D、3D 或 Streetside。

屬性	2D 範圍	3D 範圍	街邊範圍
ZoomLevel	1-20	1-20	24-26

離開 Streetside 檢視時，地圖會返回先前的檢視設定。 Streetside ZoomLevel 不會在 Streetside 體驗之外維護。

當您想要以您自己的 UI 控制項取代預設 UI 控制項時，請考慮此方法。