Les sections suivantes expliquent comment utiliser les interacteurs de sélection.
SelectionInteractor
SelectionInteractor gère l'interaction entre un graphe et son objet
Selection
en ajoutant et supprimant les éléments sélectionnés. Par défaut, lorsque vous cliquez sur un élément, la sélection est vide et cet élément est sélectionné. Si vous cliquez sur un élément tout en maintenant la touche Ctrl enfoncée, cet élément est ajouté à la sélection. Si cet élément est déjà sélectionné, il est supprimé de la sélection. Si vous cliquez sur une zone libre du diagramme, la sélection est vide. Vous pouvez également utiliser
SelectionInteractor
sans widget Diagram
en l'activant dans le graphe :graph = surface.createGraph(); graph.setSelect(true);
MarqueeSelectionInteractor
MarqueeSelectionInteractor est disponible dans le widget
DiagramEditor
.
Cet interacteur vous permet de sélectionner plusieurs éléments en sélectionnant une zone rectangulaire du diagramme.Lorsque cliquez sur une zone libre du diagramme et que vous déplacez la souris, un rectangle translucide est dessiné dans la fenêtre d'affichage (
Viewport
).
Lorsque vous relâchez le bouton de la souris, les éléments délimités sont sélectionnés.
Par défaut, les éléments partiellement délimités sont inclus dans le rectangle de sélection. Toutefois, si vous souhaitez n'inclure que les éléments entièrement délimités par le rectangle de sélection, vous pouvez définir la méthode setPartialSelectionEnabled sur false
.
Les modes de MarqueeSelectionInteractor peuvent être modifiés à l'aide de DiagramEditor en utilisant la méthode setMarqueeMode(mode).
- De niveau supérieur uniquement :Mode par défaut. Sélectionne uniquement les éléments de niveau supérieur (ceux créés dans le graphe). Définissez ce mode à l'aide de la constante topLevelOnly.
- Parent de niveau supérieur :Sélectionne uniquement le parent de niveau le plus élevé des éléments sélectionnés. Par exemple, si un sous-graphe complet est délimité, seul le sous-graphe est sélectionné, pas ses enfants. Si le sous-graphe n'est pas délimité par le rectangle de sélection, ses enfants délimités sont sélectionnés. Définissez ce mode à l'aide de la constante topParent.
- Tout:Sélectionne tous les éléments délimités. Définissez ce mode à l'aide de la constante all.
La sélection multiple est également possible. Si l'utilisateur répète la sélection à l'aide d'un rectangle en appuyant sur la touche de modification appropriée (Ctrl par défaut), les éléments sélectionnés sont ajoutés à la sélection sans effacer ceux qui existent déjà.