DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Multilingue
  • Gestion des langues et de l'alphabet
  • Fonction Nation et fichier des messages d'erreur
  • Identifiant des langues
  • Changement de langue
  • Changement de langue et page AWP
  • Changement de langue et messages du framework
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Définit ou identifie la langue d'affichage (libellés, messages, ...) utilisée pour les fenêtres, les pages, les états et les champs.
Cette fonction permet de développer des applications internationales pouvant être diffusées dans plusieurs langues.
Exemple
WEBDEV - Code ServeurPHPAjax
// -- Choix menu : &Fichier..&Langues..&Anglais
// Changement de langue par menu
Nation(nationAnglais)
// Réaffichage de la page d'accueil
PageUtilise(PAGE_PageAccueil)
WEBDEV - Code ServeurAjax
// Pages AWP sans contexte

// Code du bouton avec un drapeau Anglais
ScriptAffiche("../UK/Accueil.awp")

// Code du bouton avec un drapeau Français
ScriptAffiche("../FR/Accueil.awp")
Syntaxe

Modifier la langue d'exécution Masquer les détails

Nation(<Numéro de langue>)
<Numéro de langue> : Entier ou constante de type Entier
Identifiant de la langue à utiliser (valeur définie sous l'éditeur de projet).  Cet identifiant peut être renvoyé par la fonction DonneListePays.
La liste des identifiants est précisée dans les Remarques.
Le changement sera effectif :
  • WEBDEV - Code ServeurWEBDEV - Code Navigateur pour la prochaine fenêtre ou page ouverte.

Récupérer le numéro de la langue en cours Masquer les détails

<Résultat> = Nation()
<Résultat> : Entier ou constante de type Entier
Identifiant de la langue actuellement utilisée (voir Remarques).
Remarques

Gestion des langues et de l'alphabet

Par défaut, la langue dans laquelle seront affichés les libellés et les messages correspond à la langue par défaut, sélectionnée dans l'onglet "Langues" de la fenêtre de description du projet (option "Langue par défaut" du menu contextuel de la liste des langues).
La fonction ChangeAlphabet permet de connaître et de modifier l'alphabet utilisé. Lors d'un changement de langue (fonction Nation), si la nouvelle langue indiquée utilise un alphabet différent, il est nécessaire de changer cet alphabet grâce à la fonction ChangeAlphabet.
Pour connaître la langue du système en cours, utilisez la fonction SysNation.

Fonction Nation et fichier des messages d'erreur

La fonction ChargeErreur permet de charger le fichier des messages d'erreur dans la langue souhaitée. Cette fonction est indépendante de la fonction Nation.
Si un fichier d'erreur est disponible pour chaque langue gérée par l'application (ou le site), il est nécessaire de recharger ce fichier WDM après chaque changement de langue effectué avec la fonction Nation.

Identifiant des langues

Les identifiants des langues sont les suivants :
IdentifiantConstanteLangue
1nationAllemand
Allemand
2nationAméricain
Américain
3nationAnglais
Anglais
4nationAustralien
Australien
5nationFrançais
Français
6nationDanois
Danois
7nationEspagnol
Espagnol
8nationFinnois
Finnois
9nationCanadienFrançais
Canadien français
10nationIslandais
Islandais
11nationItalien
Italien
12nationNéerlandais
Néerlandais
13nationNorvégien
Norvégien
14nationPortugais
Portugais
15nationPortugaisBrésilien
Portugais brésilien
16nationRusse
Russe
17nationSuédois
Suédois
18nationTchèque
Tchèque
19nationArabe
Arabe
20nationBosniaque
Bosniaque
21nationBulgare
Bulgare
22nationChinoisTraditionnel
Chinois
23nationChinois
Chinois simplifié
24nationCoréen
Coréen
25nationCroate
Croate
26nationEstonien
Estonien
27nationGrec
Grec
28nationHébreux
Hébreux
29nationHongrois
Hongrois
30nationIrlandais
Irlandais
31nationJaponais
Japonais
32nationLetton
Letton
33nationLituanien
Lituanien
34nationPolonais
Polonais
35nationRoumain
Roumain
36nationSerbe
Serbe
37nationSlovaque
Slovaque
38nationSlovène
Slovène
39nationThaï
Thaï
40nationTurc
Turc
41nationVietnamien
Vietnamien
42nationAfrikaans
Afrikaans
43nationBengali
Bengali
44nationBiélorusse
Biélorusse
45nationCatalan
Catalan
46nationIndonésien
Indonésien
47nationMacédonien
Macédonien
48nationPendjabi
Pendjabi
49nationSindhi
Sindhi
50nationHindi
Hindi
Langues personnalisées
201
Langue 1
202
Langue 2
203
Langue 3
204
Langue 4
205
Langue 5
206
Langue 6
207
Langue 7
208
Langue 8
209
Langue 9
210
Langue 10
211
Langue 11
212
Langue 12

Changement de langue

  • La fonction Nation change la langue d'exécution.
    Le changement sera effectif :
    • WEBDEV - Code ServeurWEBDEV - Code Navigateur pour la prochaine fenêtre ou page ouverte.
    Après l'appel de la fonction Nation, les fenêtres, les pages, ... affichent les titres, les libellés, ... dans la langue demandée.
  • Pour modifier la langue de la fenêtre ou de la page en cours, il est nécessaire de :
    • réafficher la fenêtre (ou la page) concernée avec la fonction Utilise (ou la fonction PageUtilise ou FramesetUtilise), après l'utilisation de la fonction Nation.
    WEBDEV - Code Navigateur Le changement de langue est disponible uniquement dans les pages statiques et dynamiques PHP. Ce changement de langue est pris en compte lors du prochain appel à la fonction PageAffiche.
    Exemple :
    Nation(<Constante de la langue>)
    PageAffiche(<Nom de la page>)
  • Traduction non trouvée :
    Si la traduction d'une fenêtre, d'une page, d'un message, ... n'a pas été effectuée pour la langue spécifiée (l'élément n'est pas associé à cette langue), le mécanisme des langues préférées permet d'afficher l'information voulue dans une langue proche de celle voulue. Pour plus de détails sur le mécanisme des langues préférées, consultez Gestion de la langue de l'application par programmation.
  • Changement de langue par une option de menu :
    Si le changement de langue est effectué par une option du menu :
    • le menu reste dans la langue choisie par défaut. Pour modifier la langue du menu, il est nécessaire de réafficher :
WEBDEV - Code ServeurAjax

Changement de langue et page AWP

Pour changer la langue d'une page AWP, il est nécessaire d'utiliser tout d'abord la fonction Nation, puis d'afficher la page AWP voulue.

Changement de langue et messages du framework

La langue du framework s'adapte automatiquement à la langue de l'application définie par la fonction Nation. Par exemple :
Nation(nationFrançais) // framework en français 
Nation(nationCanadienFrançais) // framework en français
Nation(nationEspagnol) // framework en espagnol
Nation(nationCatalan) // framework en espagnol
// Autres cas : 
// Nation(nationxxx) : framework anglais
La fonction NationFramework permet de forcer l'utilisation d'une des langues pour le framework.
Composante : wd300vm.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale