PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Utilisation de la fonction ChaîneConstruit dans les applications multilingues
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Construit une chaîne de caractères en fonction d'une chaîne initiale et de paramètres.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 16 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Nouveauté 16
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
MaChaîne1 est une chaîne
MaChaîne1 = "Le fichier %1 ne peut pas être ouvert par " + ...
       "l'utilisateur %2. Le fichier %1 n'est pas accessible."
MonRésultat est une chaîne = ChaîneConstruit(MaChaîne1, "Exemple", "Tintin")
// MonRésultat contient : "Le fichier Exemple ne peut pas être
// ouvert par l'utilisateur Tintin. Le fichier Exemple n'est pas accessible."
Versions 18 et supérieures
MaChaîne1 est une chaîne
MaChaîne1 = "Le fichier %1 ne peut pas être ouvert par " + ...
"l'utilisateur %2. Le fichier %1 n'est pas accessible."
MonTableau est un tableau de 1 chaîne
MonTableau[1] = "Exemple"
MonTableau[2] = "Tintin"

MonRésultat est une chaîne = ChaîneConstruit(MaChaîne1, MonTableau)
// MonRésultat contient : "Le fichier Exemple ne peut pas être
// ouvert par l'utilisateur Tintin. Le fichier Exemple n'est pas accessible."

// La notation suivante est également disponible :
MonRésultat est une chaîne = ChaîneConstruit(MaChaîne1, ["Exemple","Tintin"])
Nouveauté 18
MaChaîne1 est une chaîne
MaChaîne1 = "Le fichier %1 ne peut pas être ouvert par " + ...
"l'utilisateur %2. Le fichier %1 n'est pas accessible."
MonTableau est un tableau de 1 chaîne
MonTableau[1] = "Exemple"
MonTableau[2] = "Tintin"

MonRésultat est une chaîne = ChaîneConstruit(MaChaîne1, MonTableau)
// MonRésultat contient : "Le fichier Exemple ne peut pas être
// ouvert par l'utilisateur Tintin. Le fichier Exemple n'est pas accessible."

// La notation suivante est également disponible :
MonRésultat est une chaîne = ChaîneConstruit(MaChaîne1, ["Exemple","Tintin"])
MaChaîne1 est une chaîne
MaChaîne1 = "Le fichier %1 ne peut pas être ouvert par " + ...
"l'utilisateur %2. Le fichier %1 n'est pas accessible."
MonTableau est un tableau de 1 chaîne
MonTableau[1] = "Exemple"
MonTableau[2] = "Tintin"

MonRésultat est une chaîne = ChaîneConstruit(MaChaîne1, MonTableau)
// MonRésultat contient : "Le fichier Exemple ne peut pas être
// ouvert par l'utilisateur Tintin. Le fichier Exemple n'est pas accessible."

// La notation suivante est également disponible :
MonRésultat est une chaîne = ChaîneConstruit(MaChaîne1, ["Exemple","Tintin"])
Syntaxe

Construction d'une chaîne à partir de paramètres Masquer les détails

<Résultat> = ChaîneConstruit(<Chaîne initiale> [, <Paramètre 1> [, ... [, <Paramètre N>]]])
<Résultat> : Chaîne de caractères
Chaîne résultat : les caractères %X ont été remplacés par les paramètres indiqués.
<Chaîne initiale> : Chaîne de caractères (avec guillemets)
Chaîne de caractères contenant des paramètres optionnels (caractères %1 à %n). Pour afficher le caractère % dans la chaîne <Résultat>, il est nécessaire de doubler ce caractère (%%).
<Paramètre 1> : Chaîne de caractères optionnelle (avec guillemets)
Premier paramètre à insérer dans la chaîne de caractères formatée.
Le <Paramètre 1> remplacera le caractère %1, le <Paramètre 2> remplacera le caractère %2, etc.
Le nombre de paramètres spécifiés doit être identique ou supérieur au nombre de paramètres utilisés dans la chaîne de caractères <Chaîne initiale>.
Si la chaîne de caractères <Chaîne initiale> contient plus de paramètres, les paramètres supplémentaires seront remplacés par des chaînes vides.
<Paramètre N> : Chaîne de caractères optionnelle (avec guillemets)
Nième paramètres à insérer dans la chaîne de caractères formatée.
Le <Paramètre 1> remplacera le caractère %1, le <Paramètre 2> remplacera le caractère %2, etc.
Le nombre de paramètres spécifiés doit être identique ou supérieur au nombre de paramètres utilisés dans la chaîne de caractères <Chaîne initiale>.
Si la chaîne de caractères <Chaîne initiale> contient plus de paramètres, les paramètres supplémentaires seront remplacés par des chaînes vides.
Versions 18 et supérieures

Construction d'une chaîne à partir de paramètres stockés dans un tableau Masquer les détails

<Résultat> = ChaîneConstruit(<Chaîne initiale> [, <Tableau des paramètres>])
<Résultat> : Chaîne de caractères
Chaîne résultat : les caractères %X ont été remplacés par les paramètres indiqués.
<Chaîne initiale> : Chaîne de caractères (avec guillemets)
Chaîne de caractères contenant des paramètres optionnels (caractères %1 à %n). Pour afficher le caractère % dans la chaîne <Résultat>, il est nécessaire de doubler ce caractère (%%).
<Tableau des paramètres> : Tableau
Nom du tableau à une dimension contenant les différents paramètres à insérer dans la chaîne de caractères formatée.
Le premier élément du tableau remplacera le caractère %1, le second élément du tableau remplacera le caractère %2, ...
Le nombre d'éléments du tableau doit être identique ou supérieur au nombre de paramètres utilisés dans la chaîne de caractères <Chaîne initiale>.
Si la chaîne de caractères <Chaîne initiale> contient plus de paramètres, les paramètres supplémentaires seront remplacés par des chaînes vides.
Remarque : Il est également possible de passer directement le tableau en paramètre en utilisant la notation : [<Elément1>, ..., <ElémentN>].
Nouveauté 18

Construction d'une chaîne à partir de paramètres stockés dans un tableau Masquer les détails

<Résultat> = ChaîneConstruit(<Chaîne initiale> [, <Tableau des paramètres>])
<Résultat> : Chaîne de caractères
Chaîne résultat : les caractères %X ont été remplacés par les paramètres indiqués.
<Chaîne initiale> : Chaîne de caractères (avec guillemets)
Chaîne de caractères contenant des paramètres optionnels (caractères %1 à %n). Pour afficher le caractère % dans la chaîne <Résultat>, il est nécessaire de doubler ce caractère (%%).
<Tableau des paramètres> : Tableau
Nom du tableau à une dimension contenant les différents paramètres à insérer dans la chaîne de caractères formatée.
Le premier élément du tableau remplacera le caractère %1, le second élément du tableau remplacera le caractère %2, ...
Le nombre d'éléments du tableau doit être identique ou supérieur au nombre de paramètres utilisés dans la chaîne de caractères <Chaîne initiale>.
Si la chaîne de caractères <Chaîne initiale> contient plus de paramètres, les paramètres supplémentaires seront remplacés par des chaînes vides.
Remarque : Il est également possible de passer directement le tableau en paramètre en utilisant la notation : [<Elément1>, ..., <ElémentN>].

Construction d'une chaîne à partir de paramètres stockés dans un tableau Masquer les détails

<Résultat> = ChaîneConstruit(<Chaîne initiale> [, <Tableau des paramètres>])
<Résultat> : Chaîne de caractères
Chaîne résultat : les caractères %X ont été remplacés par les paramètres indiqués.
<Chaîne initiale> : Chaîne de caractères (avec guillemets)
Chaîne de caractères contenant des paramètres optionnels (caractères %1 à %n). Pour afficher le caractère % dans la chaîne <Résultat>, il est nécessaire de doubler ce caractère (%%).
<Tableau des paramètres> : Tableau
Nom du tableau à une dimension contenant les différents paramètres à insérer dans la chaîne de caractères formatée.
Le premier élément du tableau remplacera le caractère %1, le second élément du tableau remplacera le caractère %2, ...
Le nombre d'éléments du tableau doit être identique ou supérieur au nombre de paramètres utilisés dans la chaîne de caractères <Chaîne initiale>.
Si la chaîne de caractères <Chaîne initiale> contient plus de paramètres, les paramètres supplémentaires seront remplacés par des chaînes vides.
Remarque : Il est également possible de passer directement le tableau en paramètre en utilisant la notation : [<Elément1>, ..., <ElémentN>].
Remarques

Utilisation de la fonction ChaîneConstruit dans les applications multilingues

Si votre application contient des messages affichés dans plusieurs langues, la fonction ChaîneConstruit permet de remplacer les caractères optionnels dans toutes les langues gérées.
Par exemple :
Fenêtre de saisie des messages multilangues
Liste des exemples associés :
Chaînes complexes Exemples unitaires (WINDEV) : Chaînes complexes
[ + ] Utilisation de la construction de chaînes complexes grâce à la fonction ChaîneConstruit.
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd220vm.dll
Windows Mobile wp220vm.dll
WEBDEV - Code Navigateur WDJS.DLL
Java wd220java.jar
Linux wd220vm.so
Android wd220android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Pour aller plus loin
J'ai publié un article à propos de ChaineConstruit et comment le rendre plus lisible : WinDev - Rendre ChaineConstruit plus élégant.
Vous pouvez le lire ici : http://blog.ytreza.org/windev-rendre-chaineconstruit-plus-elegant/
Johjo
02 nov. 2017
Champs RTF
Dans un champs RTF, le caractère \ doit être doublé pour être pris en compte .
exemple :
sKey est une chaîne = Remplace(gsKey,"\","\\")
MoiMême = ChaîneConstruit(MoiMême,sKey)
PHILIPPE DUCOURANT (
12 jan. 2017