SVG Find element IDs by rect
SVG Find element IDs by rect ( {* ;} objetImage ; x ; y ; largeur ; hauteur ; tabIds ) -> Résultat
| Paramètre | Type | Description | |
|---|---|---|---|
| * | Opérateur | → | Si spécifié, objetImage est un nom d'objet (chaîne) Si omis, objetImage est un champ ou une variable |
| objetPicture | Picture | → | Nom d’objet (si * spécifié) ou Champ ou Variable (si * omis) |
| x | Integer | → | Coordonnée horizontale du coin haut gauche du rectangle de sélection |
| y | Integer | → | Coordonnée verticale du coin haut gauche du rectangle de sélection |
| largeur | Integer | → | Largeur du rectangle de sélection |
| hauteur | Integer | → | Hauteur du rectangle de sélection |
| tabIds | Text array | ← | IDs des éléments dont le rectangle englobant est en intersection avec le rectangle de sélection |
| Résultat | Boolean | ← | Vrai = au moins un élément est trouvé, Faux sinon |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande SVG Find element IDs by rect remplit le tableau texte tabIds avec les IDs (attribut "id" ou "xml:id") des éléments XML dont le rectangle englobant est en intersection avec le rectangle de sélection à l’emplacement défini par les paramètres x et y.
La commande retourne Vrai si au moins un élément est trouvé (c’est-à-dire si le tableau tabIds est non vide) et Faux sinon.
Cette commande permet notamment de gérer des interfaces graphiques interactives.
Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objetImage est un nom d’objet (une chaîne). Si vous ne passez pas le paramètre, vous indiquez que le paramètre objetImage est un champ ou une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de champ ou de variable (champ ou variable objet uniquement).
Si vous travaillez avec un champ ou une variable image, la commande utilise l'image d'origine, correspondant à la source de données (datasource). En revanche, si vous travaillez avec un objet du formulaire, la commande utilise l'image courante, éventuellement modifiée via la commande SVG SET ATTRIBUTE et qui est conservée avec les propriétés de l'objet du formulaire.
Les coordonnées passées dans les paramètres x et y doivent être exprimées en pixels relativement à l’angle supérieur gauche de l’image (0,0). Vous pouvez utiliser les valeurs retournées par les Variables système MouseX et MouseY. Ces variables sont mises à jour dans les événements formulaire On Clicked, On Double Clicked ainsi que On Mouse Enter et On Mouse Move.
Note : Dans le système de coordonnées des images, [x;y] définit toujours le même point, quel que soit le format d’affichage de l’image, hormis pour le format "mosaïque".
Tous les ID d’éléments dont le rectangle englobant est en intersection avec le rectangle de sélection sont pris en compte, même ceux situés sous d’autres éléments.