Événements des outils de dessin

Article
10/15/2024

Il est utile de réagir à certains événements quand l’utilisateur utilise les outils de dessin sur la carte. Ce tableau présente tous les événements pris en charge par la classe DrawingManager.

Événement	Description
`drawingchanged`	Se déclenche lors d’un ajout ou d’une modification de coordonnée dans une forme.
`drawingchanging`	Se déclenche lorsqu’une coordonnée d’aperçu d’une forme est affichée. Par exemple, cet événement se déclenche plusieurs fois en cas de glisser-déposer d’une coordonnée.
`drawingcomplete`	Se déclenche quand une forme termine un dessin ou est retirée du mode d’édition.
`drawingerased`	Se déclenche lorsqu’une forme est effacée du gestionnaire de dessins en mode `erase-geometry`.
`drawingmodechanged`	Se déclenche lorsque le mode dessin change. Le nouveau mode de dessin est passé dans le gestionnaire d’événements.
`drawingstarted`	Se déclenche lorsque l’utilisateur commence à dessiner une forme ou en met une en mode d’édition.

Si vous souhaitez obtenir un exemple fonctionnel complet sur la façon d’afficher des données provenant d’une source de vignette vectorielle sur la carte, consultez Événements des outils de dessin dans les Exemples Azure Maps. Cet exemple vous permet de dessiner des formes sur la carte et d’observer les événements à mesure qu’ils se déclenchent. Si vous souhaitez obtenir le code source de cet exemple, consultez Exemple de code d’événements des outils de dessin.

L’image suivante est une capture d’écran de l’exemple de travail complet qui montre le fonctionnement des événements dans le module Outils de dessin.

Exemples

Examinons quelques scénarios courants qui utilisent les événements des outils de dessin.

Sélectionner des points dans une zone polygonale

Ce code montre comment superviser un événement de dessin de formes par un utilisateur. Pour cet exemple, le code supervise les formes de polygones, de rectangles et de cercles. Ensuite, il détermine les points de données de la carte qui se trouvent dans la zone dessinée. L’événement drawingcomplete est utilisé pour déclencher la logique de sélection. Dans la logique de sélection, le code parcourt tous les points de données sur la carte. Il vérifie s’il existe une intersection entre le point et la zone de la forme dessinée. Cet exemple utilise la bibliothèque open source Turf.js pour effectuer un calcul d’intersection spatiale.

Pour obtenir un exemple de travail complet sur l’utilisation des outils de dessin pour dessiner des zones polygonales sur la carte avec des points qui peuvent être sélectionnés, consultez Sélectionner des données dans la zone de polygones dessinés dans les exemples Azure Maps. Si vous souhaitez obtenir le code source de cet exemple, consultez Sélectionner des données dans un exemple de code de zone polygonale dessiné.

Dessiner une zone polygonale et effectuer une recherche

Ce code recherche des points d’intérêt à l’intérieur de la zone d’une forme une fois que l’utilisateur a terminé de dessiner celle-ci. L’événement drawingcomplete est utilisé pour déclencher la logique de recherche. Si l’utilisateur dessine un rectangle ou un polygone, une recherche est effectuée dans la forme géométrique. Si un cercle est dessiné, le rayon et la position du centre sont utilisés pour effectuer une recherche de point d’intérêt. L’événement drawingmodechanged est utilisé pour déterminer quand l’utilisateur bascule vers le mode de dessin, et cet événement efface la zone de dessin.

Pour obtenir un exemple opérationnel complet de l’utilisation des outils de dessin pour rechercher des points d’intérêt dans des zones dessinées, consultez Dessiner et rechercher une zone polygonale dans les exemples Azure Maps. Si vous souhaitez obtenir le code source de cet exemple, consultez [Dessiner et rechercher un exemple de code de zone polygonale].

Créer un outil de mesure

Le code suivant montre comment utiliser les événements de dessin pour créer un outil de mesure. drawingchanging permet de superviser la forme en cours de dessin. Lorsque l’utilisateur déplace la souris, les dimensions de la forme sont calculées. L’événement drawingcomplete permet d’effectuer un calcul final sur la forme une fois le dessin terminé. L’événement drawingmodechanged est utilisé pour déterminer quand l’utilisateur bascule en mode de dessin. De plus, l’événement drawingmodechanged efface la zone de dessin et les anciennes informations de mesure.

Pour obtenir un exemple de travail complet sur l’utilisation des outils de dessin pour mesurer des distances et des zones, consultez Créer un outil de mesure dans les exemples Azure Maps. Si vous souhaitez obtenir le code source de cet exemple, consultez Créer un exemple de code d’outil de mesure.