Vous êtes sur le site Web historique de la documentation de 4D. Les documentations sont progressivement déplacées vers developer.4d.com |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v19.8
ST CALCULER EXPRESSIONS
|
ST CALCULER EXPRESSIONS ( {* ;} objet {; débutSél {; finSél}} ) | ||||||||
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 | Objet de formulaire |
![]() |
Nom d'objet (si * est spécifié) ou Champ ou variable (si * est omis) | |||||
débutSél | Entier long |
![]() |
Début de la sélection | |||||
finSél | Entier long |
![]() |
Fin de la sélection | |||||
La commande ST CALCULER EXPRESSIONS met à jour les expressions 4D dynamiques situées dans le champ ou la variable de texte multistyle ou de 4D Write Pro désigné(e) par le paramètre objet.
Pour plus d’informations sur les expressions 4D utilisables dans les zone de texte multistyle ou une zone 4D Write Pro, reportez-vous à la description de la commande ST INSERER EXPRESSION.
La commande réévalue le résultat des expressions présentes dans l’objet en fonction du contexte courant et affiche le résultat obtenu. Par exemple, si l’expression insérée est l’heure, la valeur sera modifiée à chaque appel de la commande ST CALCULER EXPRESSIONS. Les expressions sont également calculées :
ST CALCULER EXPRESSIONS ne modifie pas le texte stylé (contenant les balises span) mais uniquement le texte brut affiché dans objet. Les valeurs calculées ne sont pas stockées dans le texte stylé, seule leur référence y est stockée.
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 passez une référence de champ ou de variable et non une chaîne.
Il n’est pas nécessaire que objet ait le focus. En revanche, si objet désigne une zone de texte multistyle, il doit être inclus dans un formulaire, sinon la commande ST CALCULER EXPRESSIONS n’a pas d’effet.
Note : Si objet désigne un document 4D Write Pro, il sera analysé par la commande même s'il n'est pas ouvert dans un objet de formulaire (voir également Expressions image).
Les paramètres optionnels débutSél et finSél vous permettent de désigner une sélection de texte dans objet. Les valeurs débutSél et finSél expriment une sélection de texte brut, sans tenir compte des balises de style ou des références éventuellement présentes. A noter qu’une référence équivaut à un seul caractère.
4D propose des constantes prédéfinies afin de désigner automatiquement des bornes de sélection dans les paramètres débutSél et finSél. Ces constantes sont placées dans le thème "Texte multistyle" :
Constante | Type | Valeur | Comment |
ST Début sélection | Entier long | -1000 | Désigne le premier caractère de la sélection courante de texte dans l’objet (*) |
ST Début texte | Entier long | 1 | Désigne le premier caractère du texte contenu dans l’objet |
ST Fin sélection | Entier long | -1001 | Désigne le dernier caractère de la sélection courante de texte dans l’objet (*) |
ST Fin texte | Entier long | 0 | Désigne le dernier caractère du texte contenu dans l’objet |
(*) Vous devez passer un nom d’objet dans objet pour pouvoir utiliser cette constante. Si vous passez une référence de variable ou de champ, la commande s’appliquera à l’ensemble du texte de l’objet.
Note : Si débutSél est supérieur à finSél (hormis si finSél vaut 0), la commande ne fait rien et la variable OK prend la valeur 0.
Vous souhaitez mettre à jour les références incluses dans la sélection de texte :
ST CALCULER EXPRESSIONS(*;"monTexte";ST Début sélection;ST Fin sélection)
Produit : 4D
Thème : Texte multistyle
Numéro :
1285
Nom intl. : ST COMPUTE EXPRESSIONS
Créé : 4D v14
Modifié : 4D v16 R5
4D - Langage ( 4D v19)
4D - Langage ( 4D v19.1)
4D - Langage ( 4D v19.4)
4D - Langage ( 4D v19.5)
4D - Langage ( 4D v19.6)
4D - Langage ( 4D v19.7)
4D - Langage ( 4D v19.8)