4D Doc Center : ST Lire texte brut

4D v14.3

ST Lire texte brut


ST Lire texte brut ( {* ;} objet {; modeRéf} ) -> Résultat

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable ou un champ
objet	Objet de formulaire	Nom d'objet (si * est spécifié) ou Variable ou champ (si * est omis)
modeRéf	Entier long	Mode de prise en charge des références présentes dans le texte
Résultat	Texte	Texte sans balises

Description

La commande ST Lire texte brut supprime toute balise de style du champ ou de la variable texte désigné(e) par les paramètres * et objet, et retourne le texte brut.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). A l'exécution, si l'objet a le focus, la commande retourne les informations de l'objet en cours d'édition ; si l'objet n'a pas le focus, la commande retourne les informations de la source de données de l'objet (variable ou champ).
Si vous omettez 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. A l'exécution, la commande retourne les informations de la variable ou du champ.

Le paramètre optionnel modeRéf permet d’indiquer la manière dont les références présentes dans objet doivent être retournées. Passez dans modeRéf une des constantes suivantes, placées dans le thème "Texte multistyle" (vous pouvez passer une constante ou une combinaison de constantes) :

Constante	Type	Valeur	Commentaire
ST Balises comme code xml	Entier long	128	Le code XML de la balise est retourné en texte brut. Par exemple pour la balise '<img src="test.jpg" alt="image">mon image</img>', le texte brut est '<img src="test.jpg" alt="image">mon image</img>'
ST Balises comme texte brut	Entier long	64	Le libellé de la balise est retourné en texte brut. Par exemple pour la balise '<img src="test.jpg" alt="image">mon image</img>', le texte brut est "mon image" (fonctionnement par défaut dans les formulaires)
ST Expressions 4D comme sources	Entier long	2	La chaîne d’origine des références d’expressions 4D est retournée
ST Expressions 4D comme valeurs	Entier long	1	Les références d’expressions 4D sont retournées sous leur forme évaluée (fonctionnement par défaut dans les formulaires)
ST Liens utilisateur comme libellés	Entier long	16	Le libellé visible du lien utilisateur est retourné (fonctionnement par défaut dans les formulaires)
ST Liens utilisateur comme liens	Entier long	32	Le contenu du lien utilisateur est retourné
ST Références comme espaces	Entier long	0	Chaque référence est retournée sous forme d’un caractère espace insécable (fonctionnement par défaut, utilisé par les autres commandes)
ST Texte visible avec Expressions 4D comme sources	Entier long	86	Retourne le texte tel qu’il est visible dans les formulaires avec la chaîne d’origine des expressions 4D. Correspond à la combinaison prédéfinie des constantes 2+4+16+64.
ST Texte visible avec Expressions 4D comme valeurs	Entier long	85	Retourne le texte tel qu’il est visible dans les formulaires avec les expressions 4D sous leur forme évaluée. Correspond à la combinaison prédéfinie de constantes 1+4+16+64.
ST URL comme libellés	Entier long	4	Le libellé visible des URLs est retourné, par exemple "Visitez notre site Web" (fonctionnement par défaut dans les formulaires)
ST URL comme liens	Entier long	8	Le lien est retourné, par exemple "http://www.4d.com"

Note : Le paramètre optionnel modeRéf n’est donc utile que si le texte contient des références, sinon le texte brut est identique quelle que soit la valeur du paramètre modeRéf.

Exemple 1

Vous cherchez le texte "très beau" parmi les valeurs d’un champ texte multistyle. La valeur a été stockée sous la forme "Il fait très beau aujourd’hui".

CHERCHER PAR FORMULE([Commentaires];ST Lire texte brut([Commentaires]Meteo)="@très beau@")

Note : Dans ce contexte, l’instruction suivante ne donnera pas le résultat escompté car le texte est enregistré avec des balises de style :

CHERCHER([Commentaires];[Commentaires]Meteo="@très beau@")

Exemple 2

Soit le texte suivant placé dans la zone multistyle "mazone" :

<span>Il est actuellement <span style="-d4-ref:'Heure courante:C178'"> </span><a href="http://www.4d.com"> Aller sur le site de 4D</a> ou <span style="-d4-ref-user:'openW'">Ouvrir une fenêtre</span></span></a></span>

Ce texte est affiché :

Si vous exécutez le code suivant :

 $txt :=ST Lire texte brut(*;"mazone";ST Références comme espaces)

     //$txt = "Il est actuellement    ou " (espaces)

 $txt :=ST Lire texte brut(*;"mazone";ST Expressions 4D comme valeurs)

     //$txt = "Il est actuellement 18:29:55  ou  "

 $txt :=ST Lire texte brut(*;"mazone";ST Expressions 4D comme sources)

     //$txt = "Il est actuellement Heure courante  ou  "

 $txt :=ST Lire texte brut(*;"mazone";ST URL comme liens)

     //$txt = "Il est actuellement  http://www.4d.com ou  "

 $txt :=ST Lire texte brut(*;"mazone";ST Texte visible avec Expressions 4D comme valeurs)

     //$txt = "Il est actuellement 17:54:30 Aller sur le site de 4D ou Ouvrir une fenêtre"

 $txt :=ST Lire texte brut(*;"mazone";ST Texte visible avec Expressions 4D comme sources)

     //$txt = "Il est actuellement Heure courante Aller sur le site de 4D ou Ouvrir une fenêtre"

 $txt :=ST Lire texte brut(*;"mazone";ST Liens utilisateur comme libellés)

     //$txt = "Il est actuellement    ou Ouvrir une fenêtre"

 $txt :=ST Lire texte brut(*;"mazone";ST Liens utilisateur comme liens)

     //$txt = "Il est actuellement    ou openW"

Variables et ensembles système

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.