Eventi degli strumenti di disegno

Articolo
09/03/2024

Quando si usano gli strumenti di disegno su una mappa, è utile rispondere a determinati eventi mentre l'utente disegna sulla mappa. Questa tabella elenca tutti gli eventi supportati dalla classe DrawingManager.

Evento	Descrizione
`drawingchanged`	Generato quando viene aggiunta o modificata una coordinata in una forma.
`drawingchanging`	Generato quando viene visualizzata una coordinata di anteprima per una forma. Questo evento ad esempio viene attivato più volte quando viene trascinata una coordinata.
`drawingcomplete`	Generato quando una forma completa il disegno o viene estratta dalla modalità di modifica.
`drawingerased`	Attivato quando una forma viene cancellata dal gestore di disegno se è in modalità `erase-geometry`.
`drawingmodechanged`	Generato quando cambia la modalità disegno. La nuova modalità di disegno viene passata nel gestore eventi.
`drawingstarted`	Generato quando l'utente inizia a disegnare una forma o attiva la modalità di modifica per una forma.

Per un esempio completo di come visualizzare i dati da un'origine di riquadri vettoriali sulla mappa, vedere Eventi degli strumenti di disegno negli esempi di Mappe di Azure. Questo esempio consente di disegnare forme sulla mappa e osservare come vengono generati gli eventi. Per il codice sorgente per questo esempio, vedere Codice di esempio degli eventi degli strumenti di disegno.

L'immagine seguente mostra uno screenshot dell'esempio di lavoro completo che illustra il funzionamento degli eventi nel modulo Strumenti di disegno.

Esempi

Verranno esaminati alcuni scenari comuni che usano gli eventi degli strumenti di disegno.

Selezionare punti nell'area poligono

Questo codice illustra come monitorare un evento di un utente che disegna forme. Per questo esempio, il codice monitora le forme di poligoni, rettangoli e cerchi. Determina quindi i punti dati della mappa che si trovano all'interno dell'area disegnata. L'evento drawingcomplete viene usato per attivare la logica di selezione. Nella logica di selezione il codice esegue il ciclo continuo di tutti i punti dati sulla mappa. Verifica se esiste un'intersezione tra il punto e l'area della forma disegnata. Questo esempio usa la libreria open source Turf.js per eseguire un calcolo di intersezione spaziale.

Per un esempio di lavoro completo su come usare gli strumenti di disegno per disegnare aree di poligono sulla mappa con punti all'interno che è possibile selezionare, vedere Selezionare i dati nell'area disegnata del poligono negli esempi di Mappe di Azure. Per il codice sorgente per questo esempio, vedere Selezionare i dati nel codice di esempio dell'area disegnata del poligono.

Disegnare ed eseguire ricerche nell'area poligono

Questo codice cerca i punti di interesse all'interno dell'area di una forma dopo che l'utente ha terminato di disegnare la forma. L'evento drawingcomplete viene usato per attivare la logica di ricerca. Se l'utente disegna un rettangolo o un poligono, viene eseguita una ricerca all'interno della geometria. Se viene disegnato un cerchio, vengono usati il raggio e il punto centrale per eseguire la ricerca dei punti di interesse. L'evento drawingmodechanged viene usato per determinare quando l'utente passa alla modalità di disegno e questo evento cancella l'area di disegno.

Per un esempio di lavoro completo su come usare gli strumenti di disegno per cercare punti di interesse all'interno di aree disegnate, vedere Disegnare e cercare l'area del poligono in esempi di Mappe di Azure. Per il codice sorgente per questo esempio, vedere [Disegnare e cercare il codice di esempio dell'area del poligono].

Creare uno strumento di misurazione

Il codice seguente mostra come è possibile usare gli eventi di disegno per creare uno strumento di misurazione. L'evento drawingchanging viene usato per monitorare la forma mentre viene disegnata. Quando l'utente sposta il mouse, vengono calcolate le dimensioni della forma. L'evento drawingcomplete viene utilizzato per eseguire un calcolo finale sulla forma al termine del disegno. L'evento drawingmodechanged viene usato per determinare quando l'utente passa a una modalità di disegno. L'evento drawingmodechanged inoltre cancella l'area di disegno e le informazioni di misurazione precedenti.

Per un esempio di lavoro completo su come usare gli strumenti di disegno per misurare le distanze e le aree, vedere Creare uno strumento di misurazione negli esempi di Mappe di Azure. Per il codice sorgente per questo esempio, vedere Creare un codice di esempio di strumento di misurazione.