Aller au contenu principal
Version: Next

OBJECT MOVE

OBJECT MOVE ( {* ;} objet ; dépH ; dépV {; redimH {; redimV {; *}}} )

ParamètreTypeDescription
*Opérateur→Si spécifié = objet est un nom d’objet (chaîne) Si omis = objet est une variable
objetany→Nom d’objet (si * est spécifié) ou Champ ou variable (si * est omis)
dépHInteger→Valeur de déplacement horizontal de l’objet (>0 = vers la droite, <0 = vers la gauche)
dépVInteger→Valeur de déplacement vertical de l’objet (>0 = vers le bas, <0 = vers le haut)
redimHInteger→Valeur de redimensionnement horizontal de l’objet
redimVInteger→Valeur de redimensionnement vertical de l’objet
*Opérateur→Si spécifié = coordonnées absolues Si omis = coordonnées relatives

Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.

Description​

La commande OBJECT MOVE permet de déplacer le ou les objet(s) du formulaire courant, défini(s) par les paramètres * et objet, de dépH pixels horizontalement et de dépV pixels verticalement. Il est également possible (optionnellement) de redimensionner le ou les objet(s) de redimH pixels horizontalement et de redimV pixels verticalement.

Le sens du déplacement ou du redimensionnement est défini par le signe des valeurs passées dans les paramètres dépH et dépV :

  • Si la valeur est positive, le déplacement ou le redimensionnement s’effectue respectivement vers la droite ou vers le bas.
  • Si la valeur est négative, le déplacement ou le redimensionnement s’effectue respectivement vers la gauche ou vers le haut.

Si vous passez le premier 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, tous les objets sélectionnés seront déplacés ou redimensionnés.

Par défaut, les valeurs de dépH, dépV, redimH et redimV modifient les coordonnées de l’objet relativement à sa position précédente. Si vous souhaitez que ces paramètres définissent des coordonnées absolues, passez le dernier paramètre optionnel *.

Cette commande fonctionne uniquement dans les contextes suivants :

  • Formulaires entrée en mode saisie,
  • Formulaires affichés via la commande DIALOG,
  • En-têtes et pieds de page des formulaires sortie affichés par les commandes MODIFY SELECTION ou DISPLAY SELECTION,
  • Formulaires en cours d'impression.

Exemple 1​

L’instruction suivante déplace le bouton “Bouton_1” de 10 pixels vers la droite et de 20 pixels vers le haut, et agrandit le bouton de 30 pixels en largeur et de 40 en hauteur :

 OBJECT MOVE(*;"Bouton_1";10;-20;30;40)

Exemple 2​

L’instruction suivante place le bouton “Bouton_1” aux coordonnées (10;20) (30;40) :

 OBJECT MOVE(*;"Bouton_1";10;20;30;40;*)

Voir aussi​

OBJECT DUPLICATE
OBJECT GET COORDINATES
OBJECT SET COORDINATES