4D v12.4

OBJET Lire texte style

Accueil

 
4D v12.4
OBJET Lire texte style

 

OBJET Lire texte style 


 

OBJET Lire texte style ( {* ;} objet {; débutSel {; finSél}} ) -> Résultat 
Paramètre Type   Description
Opérateur in Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable ou un champ
objet  Objet de formulaire in Nom d'objet (si * est spécifié) ou Variable ou champ Texte (si * est omis)
débutSel  Entier long in Début de la sélection
finSél  Entier long in Fin de la sélection
Résultat  Texte in Texte incluant les balises de style

La commande OBJET Lire texte style retourne le texte stylé présent dans le champ ou la variable de texte désigné(e) par le paramètre objet

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.

La commande retourne le texte avec les éventuelles balises de style qui lui sont associées, ce qui permet par exemple de copier et coller du texte en conservant les styles.

Les paramètres optionnels débutSel et finSel vous permettent de désigner une sélection de texte dans objet. Les valeurs débutSel et finSel expriment une sélection de texte brut, sans tenir compte des balises de style éventuellement présentes.

  • si vous omettez débutSel et finSel, OBJET Lire texte style retourne la totalité du texte contenu dans objet,
  • si vous passez débutSel et finSel, OBJET Lire texte style retourne la sélection de texte définie par ces bornes.

Si les valeurs de débutSel et finSel sont égales ou si débutSel est supérieur à finSel, une erreur est retournée.

A l’issue de l’exécution de cette commande, la variable OK prend la valeur 1 si aucune erreur n’a été rencontrée et 0 dans le cas contraire. C’est le cas notamment lorsque l’évaluation des balises de style échoue (balise incorrecte ou manquante). 

A noter qu’en cas d’erreur, la variable n’est pas modifiée. Lorsqu’une erreur se produit sur une variable lors de l’évaluation du texte, 4D transforme le texte en texte brut ; par conséquent, les caractères <, > et & seront convertis en entités HTML.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Propriétés des objets
Numéro : 1116
Nom intl. : OBJECT Get styled text

Cette commande modifie la variable système OK

 
HISTORIQUE 

New
Créé : 4D v12
Modifié : 4D v12.1

 
VOIR AUSSI  

OBJET FIXER TEXTE STYLE
OBJET Lire texte brut