Freigeben über


Verarbeiten von Kartenereignissen

In diesem Artikel wird die Verwendung der Klasse von Kartenereignissen gezeigt. Die Eigenschaft hebt Ereignisse auf der Karte und auf verschiedenen Ebenen der Karte hervor. Sie können auch Ereignisse hervorheben, wenn Sie mit einem HTML-Marker interagieren.

Interaktion mit der Karte

Im Beispiel Kartenereignisse wird der Name der Ereignisse, die während der Interaktion mit der Karte ausgelöst werden, hervorgehoben. Den Quellcode für dieses Beispiel finden Sie unter Quellcode für Zuordnungsereignisse.

Screenshot: Karte mit einer Liste von Kartenereignissen, die immer dann hervorgehoben werden, wenn Ihre Aktionen auf der Karte das betreffende Ereignis auslösen

Interaktion mit Kartenebenen

Im Beispiel Ebenenereignisse wird der Name der Ereignisse, die während der Interaktion mit der Symbolebene ausgelöst werden, hervorgehoben. Die Symbol-, Blasen-, Linien- und Polygonebenen unterstützen den gleichen Satz von Ereignissen. Die Wärmebild- und Kachelebenen unterstützen keines dieser Ereignisse. Den Quellcode für dieses Beispiel finden Sie unter Quellcode für Ebenenereignisse.

Screenshot: Karte mit einer Liste von Ebenenereignissen, die immer dann hervorgehoben werden, wenn Ihre Aktionen auf der Symbolebene das betreffende Ereignis auslösen

Interaktion mit dem HTML-Marker

Im Beispiel HTML-Markerebenenereignisse wird der Name der Ereignisse, die während der Interaktion mit der HTTML-Markerebene ausgelöst werden, hervorgehoben. Den Quellcode für dieses Beispiel finden Sie unter Quellcode für HTML-Marker-Ebenenereignisse.

Screenshot: Karte mit einer Liste von Ereignissen der HTML-Markerebene, die immer dann hervorgehoben werden, wenn Ihre Aktionen auf der Karte das betreffende Ereignis auslösen

In der folgenden Tabelle sind alle unterstützten „map class“-Ereignisse aufgelistet.

Ereignis BESCHREIBUNG
boxzoomend Wird ausgelöst, wenn eine Interaktion vom Typ „Feld zoomen“ beendet wird.
boxzoomstart Wird ausgelöst, wenn eine Interaktion vom Typ „Feld zoomen“ gestartet wird.
click Wird ausgelöst, wenn ein Zeigegerät an derselben Stelle auf der Karte gedrückt und losgelassen wird.
close Wird ausgelöst, wenn das Popup manuell oder programmgesteuert geschlossen wird.
contextmenu Wird ausgelöst, wenn mit der rechten Maustaste geklickt wird.
data Wird ausgelöst, wenn Kartendaten geladen oder geändert werden.
dataadded Wird ausgelöst, wenn Formen zu DataSource hinzugefügt werden.
dataremoved Wird ausgelöst, wenn Formen aus DataSource entfernt werden.
datasourceupdated Wird ausgelöst, wenn das DataSource-Objekt aktualisiert wird.
dblclick Wird ausgelöst, wenn mit einem Zeigegerät zweimal an derselben Stelle auf der Karte geklickt wird.
drag Wird während einer Interaktion vom Typ „zum Schwenken ziehen“ für die Karte, das Popup oder den HTML-Marker wiederholt ausgelöst.
dragend Wird ausgelöst, wenn eine Interaktion vom Typ „zum Schwenken ziehen“ für die Karte, das Popup oder den HTML-Marker beendet wird.
dragstart Wird ausgelöst, wenn eine Interaktion vom Typ „zum Schwenken ziehen“ für die Karte, das Popup oder den HTML-Marker gestartet wird.
error Wird ausgelöst, wenn ein Fehler auftritt.
idle

Wird ausgelöst, nachdem der letzte Frame gerendert wurde, jedoch bevor die Karte in den Leerlauf wechselt:

  • Es werden keine Kameraübergänge ausgeführt.
  • Alle zurzeit angeforderten Kacheln wurden geladen.
  • Alle Ausblend-/Übergangsanimationen wurden abgeschlossen.

keydown Wird ausgelöst, wenn eine Taste gedrückt wird.
keypress Wird ausgelöst, wenn eine Taste gedrückt wird, die ein eingebbares Zeichen (einen ANSI-Schlüssel) erzeugt.
keyup Wird ausgelöst, wenn eine Taste losgelassen wird.
layeradded Wird ausgelöst, wenn der Karte eine Ebene hinzugefügt wird.
layerremoved Wird ausgelöst, wenn aus der Karte eine Ebene entfernt wird.
load Wird sofort ausgelöst, nachdem alle erforderlichen Ressourcen heruntergeladen wurden und das erste visuell vollständige Rendering der Karte stattgefunden hat.
mousedown Wird ausgelöst, wenn ein Zeigegerät innerhalb der Karte oder auf einem Element gedrückt wird.
mouseenter Wird ausgelöst, wenn ein Zeigegerät anfänglich über die Karte oder ein Element bewegt wird.
mouseleave Wird ausgelöst, wenn ein Zeigegerät aus der Karte oder aus einem Element herausbewegt wird.
mousemove Wird ausgelöst, wenn ein Zeigegerät innerhalb der Karte oder in einem Element bewegt wird.
mouseout Wird ausgelöst, wenn ein Zeigegerät den Zeichenbereich der Karte oder eines Elements verlässt.
mouseover Wird ausgelöst, wenn ein Zeigegerät über die Karte oder ein Element bewegt wird.
mouseup Wird ausgelöst, wenn ein Zeigegerät innerhalb der Karte oder auf einem Element losgelassen wird.
move Wird während eines animierten Übergangs von einer Ansicht zu einer anderen wiederholt ausgelöst, entweder infolge einer Benutzerinteraktion oder durch Methoden.
moveend Wird ausgelöst, kurz nachdem die Karte den Übergang von einer Ansicht zu einer anderen abgeschlossen hat, entweder infolge einer Benutzerinteraktion oder durch Methoden.
movestart Wird ausgelöst, kurz bevor die Karte den Übergang von einer Ansicht zu einer anderen beginnt, entweder infolge einer Benutzerinteraktion oder durch Methoden.
open Wird ausgelöst, wenn das Popup manuell oder programmgesteuert geöffnet wird.
pitch Wird ausgelöst, sobald sich die Neigung der Karte entweder infolge einer Benutzerinteraktion oder durch Methoden ändert.
pitchend Wird ausgelöst, unmittelbar nachdem das Ändern der Kartenneigung beendet wurde, entweder infolge einer Benutzerinteraktion oder durch Methoden.
pitchstart Wird ausgelöst, sobald mit dem Ändern der Kartenneigung begonnen wird, entweder infolge einer Benutzerinteraktion oder durch Methoden.
ready Wird ausgelöst, wenn die mindestens erforderlichen Kartenressourcen geladen werden, bevor mit der Karte programmgesteuert interagiert werden kann.
render

Wird ausgelöst, sobald die Karte aufgrund eines der folgenden Ereignisse auf dem Bildschirm gezeichnet wird:

  • Eine Änderung der Position, des Zooms, der Neigung oder der Peilung der Karte.
  • Eine Änderung des Kartenstils.
  • Eine Änderung an einer DataSource-Quelle.
  • Das Laden einer Vektorkachel, einer GeoJSON-Datei, eines Glyphen oder eines Sprites.

resize Wird unmittelbar nach einer Größenänderung der Karte ausgelöst.
rotate Wird während einer Interaktion vom Typ „zum Drehen ziehen“ wiederholt ausgelöst.
rotateend Wird ausgelöst, wenn eine Interaktion vom Typ „zum Drehen ziehen“ beendet wird.
rotatestart Wird ausgelöst, wenn eine Interaktion vom Typ „zum Drehen ziehen“ gestartet wird.
shapechanged Wird ausgelöst, wenn eine Shape-Objekteigenschaft geändert wird.
sourcedata Wird ausgelöst, wenn eine Kartenquelle oder eine Kachel, die zu einer Quelle gehört, geladen oder geändert wird.
sourceadded Wird ausgelöst, wenn der Karte DataSource oder VectorTileSource hinzugefügt wird.
sourceremoved Wird ausgelöst, wenn aus der Karte DataSource oder VectorTileSource entfernt wird.
styledata Wird ausgelöst, wenn der Kartenstil geladen oder geändert wird.
styleimagemissing Wird ausgelöst, wenn eine Ebene versucht, ein Bild aus dem noch nicht vorhandenen Bild-Sprite zu laden.
tokenacquired Wird ausgelöst, wenn ein Microsoft Entra-Zugriffstoken abgerufen wird.
touchcancel Wird ausgelöst, wenn ein touchcancel-Ereignis innerhalb der Karte auftritt.
touchend Wird ausgelöst, wenn ein touchend-Ereignis innerhalb der Karte auftritt.
touchmove Wird ausgelöst, wenn ein touchmove-Ereignis innerhalb der Karte auftritt.
touchstart Wird ausgelöst, wenn ein touchstart-Ereignis innerhalb der Karte auftritt.
wheel Wird ausgelöst, wenn ein Mausradereignis innerhalb der Karte auftritt.
zoom Wird während eines animierten Übergangs von einem Zoomfaktor zu einem anderen wiederholt ausgelöst, entweder infolge einer Benutzerinteraktion oder durch Methoden.
zoomend Wird ausgelöst, kurz nachdem die Karte den Übergang von einem Zoomfaktor zu einem anderen abgeschlossen hat, entweder infolge einer Benutzerinteraktion oder durch Methoden.
zoomstart Wird ausgelöst, kurz bevor die Karte den Übergang von einem Zoomfaktor zu einem anderen beginnt, entweder infolge einer Benutzerinteraktion oder durch Methoden.

Nächste Schritte

Die folgenden Artikel enthalten vollständige Codebeispiele: