La commande OBJET Lire multiligne 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 OBJET FIXER MULTILIGNE.
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 |
Multiligne 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 |
Multiligne Non |
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é |
Multiligne Oui |
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 OBJET Lire multiligne à un objet ne prenant pas en charge l’option "Multilignes", la valeur 0 est retournée.