OBJECT Get multiline
OBJECT Get multiline ( {* ;} 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 | ← | Statut multiligne de l’objet |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande OBJECT Get multiline retourne le statut courant de l’option "Multilignes" de l’objet ou des objets désigné(s) par les paramètres objet et *.
L’option "Multilignes" 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 MULTILINE.
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 |
|---|---|---|---|
| Multiline Auto | Entier long | 0 | Dans les zones mono-lignes, les mots situés en fin de ligne sont tronqués et il n’y a pas de retours à la ligne. Dans les zones multi-lignes, 4D effectue des retours à la ligne automatiques |
| Multiline No | Entier long | 2 | Il n’y a aucun retour à la ligne : le texte est toujours affiché sur une seule ligne. Si le champ ou la variable alpha ou texte contient des retour chariots, le texte situé après le premier retour chariot est effacé dès que la zone est modifié |
| Multiline Yes | Entier long | 1 | Dans les zones mono-lignes, le texte est affiché jusqu’au premier retour chariot ou au dernier mot affichable en entier. 4D insère des retours à la ligne, il est possible de faire défiler le contenu de la zone en appuyant sur la touche flèche basse. Dans les zones multi-lignes, 4D effectue des retours à la ligne automatiques |
Note : Si vous appliquez la commande OBJECT Get multiline à un objet ne prenant pas en charge l’option "Multilignes", la valeur 0 est retournée.