Freigeben über


MapControl.TryZoomInAsync Methode

Definition

Startet einen asynchronen Vorgang zum Vergrößern, wobei der ZoomLevel der Karte um eins erhöht wird.

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)

Gibt zurück

Enthält die Ergebnisse des Vorgangs: true , wenn der Vorgang erfolgreich abgeschlossen wurde; andernfalls false.

Attribute

Hinweise

Warnung

Es wird nicht empfohlen, ZoomLevel mit 3D-Ansichten zu ändern. Wenn die MapControl-Ansicht nicht gerade nach unten aussieht, können Änderungen in ZoomLevel zu unvorhersehbarem Verhalten führen.

ZoomLevel ist für 2D-Ansichten vorgesehen. Um einen Zoomeffekt mit 3D-Ansichten zu implementieren, verwenden Sie die TrySetSceneAsync-Methode von MapControl, um die Kamera näher zu bringen. Legen Sie zunächst einen näheren Standort für ein MapCamera-Objekt fest. Erstellen Sie als Nächstes eine neue MapScene , indem Sie diese MapCamera an CreateFromCamera übergeben. Initiieren Sie schließlich den Zoom, indem Sie die neue MapScene an TrySetSceneAsync übergeben. Sie können sofort vergrößern oder MapAnimationKind angeben, um ein animiertes "Fly In" zu erstellen.

Die Maximal- und Mindestwerte von ZoomLevel, die von den Eigenschaften MaxZoomLevel und MinZoomLevel gemeldet werden, hängen vom Typ der Kartenansicht ab: 2D, 3D oder Streetside.

Eigenschaft2D-Bereich3D-BereichStraßenbereich
ZoomLevel1–201–2024-26

Wenn Sie eine Straßenansicht verlassen, kehrt die Karte zu den vorherigen Ansichtseinstellungen zurück. Das Streetside ZoomLevel wird außerhalb der Streetside-Umgebung nicht beibehalten.

Ziehen Sie diese Methode in Betracht, wenn Sie das Standard-UI-Steuerelement durch Ihr eigenes ersetzen möchten.

Gilt für: