4D Doc Center : OBJET LIRE COORDONNEES

4D v14.3

OBJET LIRE COORDONNEES


OBJET LIRE COORDONNEES ( {* ;} objet ; gauche ; haut ; droite ; bas )

Paramètre	Type	Description
*	Opérateur	Si spécifié = objet est un nom d’objet (chaîne) Si omis = objet est une variable
objet	Objet de formulaire	Nom d’objet (si * est spécifié) ou Champ ou variable (si * est omis)
gauche	Entier long	Coordonnée gauche de l’objet
haut	Entier long	Coordonnée supérieure de l’objet
droite	Entier long	Coordonnée droite de l’objet
bas	Entier long	Coordonnée inférieure de l’objet

Description

La commande OBJET LIRE COORDONNEES retourne dans les variables ou champs gauche, haut, droite et bas les coordonnées (en points) du ou des objet(s) du formulaire courant défini(s) par les paramètres * et objet.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne de caractères). Si vous ne passez pas le paramètre *, vous indiquez que objet 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 de type objet uniquement).

Si vous passez un nom d’objet dans le paramètre objet et utilisez le caractère joker @ afin de sélectionner plusieurs objets, les coordonnées retournées seront celles du rectangle formé par l’ensemble des objets concernés.

Note : Il est possible de paramétrer le mode d’interprétation du caractère @, lorsque celui-ci est inclus dans une chaîne de caractères. Cette option influe sur le fonctionnement des commandes du thème “Propriétés des objets”. Pour plus d'informations, reportez-vous au manuel Mode Développement.

Si l’objet n’existe pas ou si la commande est appelée ailleurs que dans le contexte d’un formulaire, les coordonnées retournées sont (0;0;0;0).

Exemple

Vous souhaitez obtenir les coordonnées du rectangle formé par tous les objets dont le nom commence par “bouton” :

OBJET LIRE COORDONNEES(*;"bouton@";gauche;haut;droite;bas)