4D Doc Center : OBJET LIRE ATTRIBUT TEXTE STYLE

4D v13.4

OBJET LIRE ATTRIBUT TEXTE STYLE


OBJET LIRE ATTRIBUT TEXTE STYLE ( {* ;} objet ; débutSél ; finSél ; nomAttribut ; valeurAttribut {; nomAttribut2 ; valeurAttribut2 ; ... ; nomAttributN ; valeurAttributN} )

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)
débutSél	Entier long	Début de la sélection de texte
finSél	Entier long	Fin de la sélection de texte
nomAttribut	Entier long	Attribut à lire
valeurAttribut	Variable	Valeur courante de l’attribut

Description

La commande OBJET LIRE ATTRIBUT TEXTE STYLE permet de récupérer la valeur courante d’un attribut de style dans une sélection de texte du ou des objet(s) de formulaire désigné(s) par objet.

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.

Les paramètres débutSel et finSel permettent de désigner la sélection de texte de laquelle lire l’attribut de style. Passez dans débutSel la position du premier caractère et dans finSel la position plus un du dernier caractère de la sélection. Vous pouvez passer 0 dans finSel afin de désigner automatiquement le dernier caractère du texte (passez 1 dans débutSel pour désigner le premier caractère).
Si les valeurs de débutSel et finSel sont égales ou si débutSel est supérieur à finSel (hormis si finSel vaut 0), une erreur est retournée.
Les valeurs débutSel et finSel ne tiennent pas compte des balises de style éventuellement déjà présentes dans la zone. Elles sont évaluées sur la base du texte brut (texte duquel les balises de style ont été filtrées).

Passez dans le paramètre nomAttribut le nom de l’attribut à lire et dans le paramètre valeurAttribut une variable devant récupérer la valeur courante de l’attribut. Pour définir le paramètre nomAttribut, vous devez utiliser l’une des constantes du thème Attributs de texte multistyle.

Constante	Type	Valeur	Commentaire
Attribut couleur fond	Entier long	8	valeurAttribut=Valeur hexadécimale ou nom de couleur HTML (Windows uniquement)
Attribut couleur texte	Entier long	7	valeurAttribut=Valeur hexadécimale ou nom de couleur HTML
Attribut nom de police	Entier long	5	valeurAttribut=Nom de la famille de police (chaîne)
Attribut style barré	Entier long	3	valeurAttribut=0 : pas d'attribut barré pour la sélection valeurAttribut=1 : attribut barré pour la sélection
Attribut style gras	Entier long	1	valeurAttribut=0 : pas d'attribut gras pour la sélection valeurAttribut=1 : attribut gras pour la sélection
Attribut style italique	Entier long	2	valeurAttribut=0 : pas d'attribut italique pour la sélection valeurAttribut=1 : attribut italique pour la sélection
Attribut style souligné	Entier long	4	valeurAttribut=0 : pas d'attribut souligné pour la sélection valeurAttribut=1 : attribut souligné pour la sélection
Attribut taille texte	Entier long	6	valeurAttribut=Nombre de points (numérique)

Vous pouvez passer autant de paires attribut/valeur que vous souhaitez.

Si la valeur de l’attribut nomAttribut est identique dans la totalité de la sélection, elle est retournée dans valeurAttribut. Si cette valeur est différente ou si objet ne contient pas de balises SPAN, les valeurs suivantes sont retournées :

nomAttribut	valeurAttribut si attribut hétérogène dans la sélection ou pas de balises SPAN
Attribut couleur fond	FFFFFFFF
Attribut couleur texte	FFFFFFFF
Attribut nom de police	"" (chaîne vide)
Attribut style barré	2
Attribut style gras	2
Attribut style italique	2
Attribut style souligné	2
Attribut taille texte	-1

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.