4D Doc Center : SVG Chercher ID elements par rect

4D v14.3

SVG

SVG Chercher ID elements par rect


SVG Chercher ID elements par 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
objetImage	Image	Nom d’objet (si * spécifié) ou Champ ou Variable (si * omis)
x	Entier long	Coordonnée horizontale du coin haut gauche du rectangle de sélection
y	Entier long	Coordonnée verticale du coin haut gauche du rectangle de sélection
largeur	Entier long	Largeur du rectangle de sélection
hauteur	Entier long	Hauteur du rectangle de sélection
tabIds	Tableau texte	IDs des éléments dont le rectangle englobant est en intersection avec le rectangle de sélection
Résultat	Booléen	Vrai = au moins un élément est trouvé, Faux sinon

Description

La commande SVG Chercher ID elements par 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 FIXER ATTRIBUT 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 MouseX et MouseY. Ces variables sont mises à jour dans les événements formulaire Sur clic, Sur double clic ainsi que Sur début survol et Sur survol.

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.