La commande OBJET Lire orientation texte retourne la valeur d’orientation courante appliquée au texte de l’objet ou des objets désigné(s) par les paramètres objet et *.
L’option "Orientation" d’un objet peut avoir été définie en mode Développement via la Liste des propriétés ou à l’aide de la commande OBJET FIXER ORIENTATION TEXTE.
Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). Si vous ne passez pas le paramètre, vous indiquez que le paramètre 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 objet uniquement).
La valeur retournée correspond à l’une des constantes suivantes du thème "Objets de formulaire (Propriétés)" :
Constante |
Type |
Valeur |
Commentaire |
Orientation 0° |
Entier long |
0 |
Pas de rotation (valeur par défaut) |
Orientation 180° |
Entier long |
180 |
Orientation du texte à 180° dans le sens horaire |
Orientation 90° droite |
Entier long |
90 |
Orientation du texte à 90° dans le sens horaire |
Orientation 90° gauche |
Entier long |
270 |
Orientation du texte à 90° dans le sens anti-horaire |
Soit l’objet suivant (une orientation "90° gauche" lui a été appliquée dans l’éditeur de formulaires) :
Si, à l’exécution du formulaire, vous appelez l’instruction suivante :
... l’objet prend alors l’apparence suivante :
$vOrt:=OBJET Lire orientation texte(*;"monTexte")