Condividi tramite


Gestire gli eventi della mappa

Questo articolo illustra come usare la classe degli eventi della mappa. La proprietà consente di evidenziare gli eventi nella mappa e nei diversi livelli della mappa. È anche possibile evidenziare gli eventi quando si interagisce con un marcatore HTML.

Interazione con la mappa

L'esempio Eventi mappa evidenzia il nome degli eventi che vengono generati durante l'interazione con la mappa. Per il codice sorgente per questo campione, vedere il codice sorgente di Eventi mappa.

Screenshot che mostra una mappa con un elenco di eventi che vengono evidenziati ogni volta che le azioni sulla mappa attivano un determinato evento.

Interagire con i livelli mappa

L'esempio Eventi livello evidenzia il nome degli eventi che vengono generati durante l'interazione con il livello simbolo. I livelli di simbolo, bolla, linea e poligono supportano lo stesso set di eventi. La mappa termica e i livelli delle tessere non supportano nessuno di questi eventi. Per il codice sorgente per questo campione, vedere il codice sorgente di Eventi livello.

Screenshot che mostra una mappa con un elenco di eventi livello che vengono evidenziati ogni volta che si interagisce con il livello simbolo.

Interagire con il marcatore di HTML

L'esempio Eventi livello marcatore HTML evidenzia il nome degli eventi che vengono generati durante l'interazione con il livello marcatore HTML. Per il codice sorgente per questo campione, vedere il codice sorgente di Eventi livello marcatore HTML.

Screenshot che mostra una mappa con un elenco di eventi del livello marcatore HTML che vengono evidenziati ogni volta che le azioni sulla mappa attivano un determinato evento.

Nella tabella seguente sono elencati tutti gli eventi della classe mappa supportati.

Evento Descrizione
boxzoomend Generato al termine di un'interazione con lo zoom della finestra.
boxzoomstart Generato all'avvio di un'interazione con lo zoom di una finestra.
click Generato quando un dispositivo di puntamento viene premuto e rilasciato nello stesso punto della mappa.
close Generato quando il popup viene chiuso manualmente o a livello di codice.
contextmenu Generato quando si fa clic sul pulsante destro del mouse.
data Generato quando vengono caricati o modificati dati della mappa.
dataadded Generato quando vengono aggiunte forme a DataSource.
dataremoved Generato quando vengono rimosse forme da DataSource.
datasourceupdated Generato quando viene aggiornato l'oggetto DataSource.
dblclick Generato quando si fa doppio clic su un dispositivo di puntamento nello stesso punto sulla mappa.
drag Generato ripetutamente durante un'interazione di "trascinamento per una panoramica" sulla mappa, il popup o il marcatore HTML.
dragend Generato quando un'interazione di "trascinamento per una panoramica" termina sulla mappa, il popup o il marcatore HTML.
dragstart Generato quando un'interazione di "trascinamento per una panoramica" inizia sulla mappa, il popup o il marcatore HTML.
error Generato quando si verifica un errore.
idle

Generato dopo il rendering dell'ultimo frame prima che la mappa passi in stato "inattivo" in questi casi:

  • Non sono in corso transizioni della fotocamera.
  • Sono stati caricati tutte le tessere attualmente richieste.
  • Sono state completate tutte le animazioni di dissolvenza/transizione.

keydown Generato quando viene premuto un tasto.
keypress Generato quando viene premuto un tasto che produce un carattere digitabile (tasto ANSI).
keyup Generato quando viene rilasciato un tasto.
layeradded Generato quando un livello viene aggiunto alla mappa.
layerremoved Generato quando un livello viene rimosso dalla mappa.
load Generato immediatamente dopo il download di tutte le risorse necessarie e il primo rendering visivo completo della mappa.
mousedown Generato quando un dispositivo di puntamento viene premuto all'interno della mappa o quando si trova sopra un elemento.
mouseenter Generato quando un dispositivo di puntamento viene spostato inizialmente sulla mappa o su un elemento.
mouseleave Generato quando un dispositivo di puntamento viene spostato fuori dalla mappa o da un elemento.
mousemove Generato quando un dispositivo di puntamento viene spostato all'interno della mappa o di un elemento.
mouseout Generato quando un dispositivo di puntamento lascia l'area canvas della mappa o un elemento.
mouseover Generato quando un dispositivo di puntamento viene spostato sulla mappa o su un elemento.
mouseup Generato quando un dispositivo di puntamento viene rilasciato all'interno della mappa o quando si trova sopra un elemento.
move Generato ripetutamente durante una transizione animata da una vista a un'altra, come risultato dell'interazione utente o dei metodi.
moveend Generato immediatamente dopo che la mappa completa una transizione da una vista a un'altra, come risultato dell'interazione utente o dei metodi.
movestart Generato immediatamente prima che la mappa inizi una transizione da una vista a un'altra, come risultato dell'interazione utente o dei metodi.
open Generato quando il popup viene aperto manualmente o a livello di codice.
pitch Generato ogni volta che l'inclinazione della mappa viene modificata in seguito all'interazione o ai metodi dell'utente.
pitchend Generato immediatamente dopo che l'inclinazione della mappa completa una modifica come risultato dell'interazione utente o dei metodi.
pitchstart Generato ogni volta che l'inclinazione della mappa avvia una modifica come risultato dell'interazione utente o dei metodi.
ready Generato quando vengono caricate le risorse minime obbligatorie della mappa prima che la mappa sia pronta per interagire a livello di codice.
render

Generato ogni volta che la mappa viene disegnata sullo schermo come risultato di:

  • Una modifica a posizione, zoom, orientamento o inclinazione della mappa.
  • Una modifica allo stile della mappa.
  • Una modifica a un'origine DataSource.
  • Il caricamento di une tessera vettoriale, di un file GeoJSON, di un glifo o di uno sprite.

resize Generato immediatamente dopo il ridimensionamento della mappa.
rotate Generato ripetutamente durante un'interazione di "trascinamento per la rotazione".
rotateend Generato quando termina l'interazione un'interazione di "trascinamento per la rotazione".
rotatestart Generato quando inizia l'interazione di "trascinamento per la rotazione".
shapechanged Generato quando viene modificata una proprietà dell'oggetto Shape.
sourcedata Generato quando una delle origini della mappa viene caricata o modificata, incluso se una tessera appartenente a un'origine viene caricata o modificata.
sourceadded Generato quando viene aggiunto alla mappa un oggetto DataSource o VectorTileSource.
sourceremoved Generato quando viene rimosso dalla mappa un oggetto DataSource o VectorTileSource.
styledata Generato quando lo stile della mappa viene caricato o modificato.
styleimagemissing Generato quando un livello tenta di caricare un'immagine dallo sprite dell'immagine che non esiste
tokenacquired Generato quando viene ottenuto il token di accesso Microsoft Entra.
touchcancel Generato quando si verifica un evento touchcancel all'interno della mappa.
touchend Generato quando si verifica un evento touchend all'interno della mappa.
touchmove Generato quando si verifica un evento touchmove all'interno della mappa.
touchstart Generato quando si verifica un evento touchstart all'interno della mappa.
wheel Generato quando si verifica un evento della rotellina del mouse all'interno della mappa.
zoom Generato ripetutamente durante una transizione animata da un livello di zoom a un altro, come risultato dell'interazione utente o dei metodi.
zoomend Generato immediatamente dopo che la mappa completa una transizione da un livello di zoom a un altro, come risultato dell'interazione utente o dei metodi.
zoomstart Generato immediatamente prima che la mappa inizi una transizione da un livello di zoom a un altro, come risultato dell'interazione utente o dei metodi.

Passaggi successivi

Per esempi di codice completi, vedere gli articoli seguenti: