Udostępnij za pośrednictwem

Obsługa zdarzeń mapy

  • Artykuł

W tym artykule pokazano, jak używać klasy zdarzeń mapy. Właściwość wyróżnia zdarzenia na mapie i na różnych warstwach mapy. Zdarzenia można również wyróżnić podczas interakcji ze znacznikiem HTML.

Interakcja z mapą

Przykład zdarzeń mapy wyróżnia nazwę zdarzeń , które są wyzwalane podczas interakcji z mapą. Aby uzyskać kod źródłowy dla tego przykładu, zobacz Mapuj kod źródłowy zdarzeń.

Zrzut ekranu przedstawiający mapę z listą zdarzeń mapy, które są wyróżnione za każdym razem, gdy akcje na mapie wyzwalają to zdarzenie.

Interakcja z warstwami mapy

Przykład Zdarzenia warstwy wyróżnia nazwę zdarzeń, które są wyzwalane podczas interakcji z warstwą symboli. Symbol, bąbelek, linia i warstwa wielokątna obsługują ten sam zestaw zdarzeń. Warstwy mapy cieplnej i kafelka nie obsługują żadnego z tych zdarzeń. Aby uzyskać kod źródłowy dla tego przykładu, zobacz Kod źródłowy zdarzeń warstwy.

Zrzut ekranu przedstawiający mapę z listą zdarzeń warstwy wyróżnionych w dowolnym momencie interakcji z warstwą symboli.

Interakcja ze znacznikiem HTML

Przykład zdarzeń warstwy znacznika HTML wyróżnia nazwę zdarzeń , które są wyzwalane podczas interakcji z warstwą znacznika HTML. Aby uzyskać kod źródłowy dla tego przykładu, zobacz Kod źródłowy zdarzeń warstwy znacznika HTML.

Zrzut ekranu przedstawiający mapę z listą zdarzeń warstwy znacznika HTML, które są wyróżnione za każdym razem, gdy akcje na mapie wyzwalają to zdarzenie.

W poniższej tabeli wymieniono wszystkie obsługiwane zdarzenia klasy mapy.

Wydarzenie opis
boxzoomend Wyzwolony po zakończeniu interakcji "powiększenie pola".
boxzoomstart Wyzwolony po rozpoczęciu interakcji "powiększenie pola".
click Wyzwolono, gdy urządzenie wskazujące jest naciskane i zwalniane w tym samym punkcie na mapie.
close Wyzwolony, gdy wyskakujące okienko jest zamykane ręcznie lub programowo.
contextmenu Wyzwolony po kliknięciu prawego przycisku myszy.
data Wyzwolony, gdy wszystkie dane mapy są ładowane lub zmieniane.
dataadded Wyzwalane po dodaniu kształtów do elementu DataSource.
dataremoved Wyzwalane po usunięciu kształtów z obiektu DataSource.
datasourceupdated Wyzwolony po zaktualizowaniu DataSource obiektu.
dblclick Wyzwolono, gdy urządzenie wskazujące jest dwukrotnie klikane w tym samym punkcie na mapie.
drag Uruchamiane wielokrotnie podczas interakcji "przeciągnij do przesuwania" na mapie, w oknie podręcznym lub znaczniku HTML.
dragend Wyzwolone, gdy interakcja "przeciągnij do przesuwania" kończy się na mapie, w oknie podręcznym lub znaczniku HTML.
dragstart Wyzwalane, gdy interakcja "przeciągnij do okienka" rozpoczyna się na mapie, w oknie podręcznym lub znaczniku HTML.
error Wyzwolony po wystąpieniu błędu.
idle

Wyzwolono po ostatniej ramki renderowanej przed wprowadzeniem stanu bezczynności mapy:

  • Żadne przejścia aparatu nie są w toku.
  • Załadowano wszystkie aktualnie żądane kafelki.
  • Wszystkie animacje zanikania/przejścia zostały ukończone.
keydown Wyzwalane po naciśnięciu w dół.
keypress Wyzwolony po naciśnięciu tworzącego znak z możliwością pisania (ANSI).
keyup Wyzwolony po zwolnieniu klucza.
layeradded Wyzwalane po dodaniu warstwy do mapy.
layerremoved Wyzwolony po usunięciu warstwy z mapy.
load Wyzwolono natychmiast po pobraniu wszystkich niezbędnych zasobów i wystąpiło pierwsze wizualne renderowanie mapy.
mousedown Wyzwolono, gdy urządzenie wskazujące jest naciskane na mapie lub gdy znajduje się na wierzchu elementu.
mouseenter Wyzwolone, gdy urządzenie wskazujące jest początkowo przenoszone na mapę lub element.
mouseleave Wyzwolone po przeniesieniu urządzenia wskazującego na mapę lub element.
mousemove Wyzwalane po przeniesieniu urządzenia wskazującego w obrębie mapy lub elementu.
mouseout Wyzwolone, gdy urządzenie punktu opuszcza kanwę mapy, pozostawia element.
mouseover Wyzwolony po przeniesieniu urządzenia wskazującego na mapę lub element.
mouseup Wyzwolony, gdy urządzenie wskazujące jest zwalniane w obrębie mapy lub gdy znajduje się na wierzchu elementu.
move Wyzwolony wielokrotnie podczas animowanego przejścia z jednego widoku do drugiego w wyniku interakcji użytkownika lub metod.
moveend Wyzwolony tuż po zakończeniu przejścia z jednego widoku do innego w wyniku interakcji użytkownika lub metod.
movestart Wyzwolony tuż przed rozpoczęciem przejścia z jednego widoku do innego w wyniku interakcji użytkownika lub metod.
open Wyzwolono, gdy wyskakujące okienko jest otwierane ręcznie lub programowo.
pitch Wyzwalane za każdym razem, gdy skok mapy (pochylenie) zmienia się w wyniku interakcji użytkownika lub metod.
pitchend Wyzwolony natychmiast po zakończeniu zmiany wysokości mapy (pochylenia) w wyniku interakcji użytkownika lub metod.
pitchstart Wyzwalane za każdym razem, gdy skok mapy (pochylenie) rozpoczyna zmianę w wyniku interakcji użytkownika lub metod.
ready Wyzwolono, gdy zostaną załadowane minimalne wymagane zasoby mapy, zanim mapa będzie gotowa programowo wchodzić w interakcję.
render

Wyzwolony za każdym razem, gdy mapa zostanie narysowana na ekranie, w wyniku:

  • Zmiana położenia mapy, powiększenia, skoku lub łożyska.
  • Zmiana stylu mapy.
  • Zmiana źródła DataSource .
  • Ładowanie kafelka wektorowego, pliku GeoJSON, glyph lub sprite.
resize Wyzwolono natychmiast po zmianie rozmiaru mapy.
rotate Uruchamiany wielokrotnie podczas interakcji "przeciągnij, aby obrócić".
rotateend Wyzwalane, gdy kończy się interakcja "przeciągnij, aby obrócić".
rotatestart Wyzwalane po rozpoczęciu interakcji "przeciągnij, aby obrócić".
shapechanged Wyzwalane po zmianie właściwości obiektu kształtu.
sourcedata Wyzwolony, gdy jedno ze źródeł mapy ładuje lub zmienia się, w tym w przypadku załadowania lub zmiany kafelka należącego do źródła.
sourceadded Wyzwolony po dodaniu elementu DataSource lub VectorTileSource do mapy.
sourceremoved Wyzwolony po usunięciu elementu DataSource lub VectorTileSource z mapy.
styledata Wyzwolony, gdy styl mapy zostanie załadowany lub zmieniony.
styleimagemissing Wyzwalane, gdy warstwa próbuje załadować obraz z sprite obrazu, który nie istnieje
tokenacquired Wyzwolony po uzyskaniu tokenu dostępu entra firmy Microsoft.
touchcancel Wyzwolony po touchcancel wystąpieniu zdarzenia na mapie.
touchend Wyzwolony po touchend wystąpieniu zdarzenia na mapie.
touchmove Wyzwolony po touchmove wystąpieniu zdarzenia na mapie.
touchstart Wyzwolony po touchstart wystąpieniu zdarzenia na mapie.
wheel Wyzwalane po wystąpieniu zdarzenia koła myszy na mapie.
zoom Wyzwolony wielokrotnie podczas animowanego przejścia z jednego poziomu powiększenia do innego w wyniku interakcji użytkownika lub metod.
zoomend Wyzwolony tuż po zakończeniu przejścia z jednego poziomu powiększenia do innego w wyniku interakcji użytkownika lub metod.
zoomstart Wyzwolony tuż przed rozpoczęciem przejścia z jednego poziomu powiększenia do innego w wyniku interakcji użytkownika lub metod.

Następne kroki

Zobacz następujące artykuły, aby zapoznać się z pełnymi przykładami kodu:

Korzystanie z modułu Azure Maps Services

Przykłady kodu