OBJECT Get text orientation
OBJECT Get text orientation ( {* ;} objet ) : Integer
| Paramètre | Type | Description | |
|---|---|---|---|
| * | Opérateur | → | Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est un champ ou une variable |
| objet | any | → | Nom d'objet (si * est spécifié) ou Champ ou variable (si * est omis) |
| Résultat | Integer | ← | Angle de rotation du texte |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande OBJECT Get text orientation 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 OBJECT SET TEXT ORIENTATION.
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 | Comment |
|---|---|---|---|
| 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° left | Entier long | 270 | Orientation du texte à 90° dans le sens anti-horaire |
| Orientation 90° right | Entier long | 90 | Orientation du texte à 90° dans le sens horaire |
Exemple
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 :
OBJECT SET TEXT ORIENTATION(*;"monTexte";Orientation 180°)
... l’objet prend alors l’apparence suivante :
$vOrt:=OBJECT Get text orientation(*;"monTexte") //$vOrt=180