PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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 fichier d'aide
  • Changement de langue et groupware utilisateur
  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
PHP Cette fonction est désormais disponible pour les sites PHP.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
PHP Cette fonction est désormais disponible pour les sites PHP.
Android Cette fonction est désormais disponible pour les applications Android.
PHP Cette fonction est désormais disponible pour les sites PHP.
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
WINDEVEtats et RequêtesAndroidWidget AndroidWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)
// -- Choix menu : &Fichier..&Langues..&Anglais
// Changement de langue par menu
Nation(nationAnglais)
Utilise(FEN_MenuInt)
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).  
Versions 21 et supérieures
Cet identifiant peut être renvoyé par la fonction DonneListePays.
Nouveauté 21
Cet identifiant peut être renvoyé par la fonction DonneListePays.
Cet identifiant peut être renvoyé par la fonction DonneListePays.
La liste des identifiants est précisée dans les Remarques.
Le changement sera effectif pour la prochaine fenêtre ou page ouverte. Le changement sera effectif :
  • WINDEV immédiatement si l'option "Changement de langue immédiat après l'appel de la fonction Nation" est sélectionnée dans l'onglet "Avancé" de la description du projet. WINDEV immédiatement si l'option "Changement de langue immédiat après l'appel de la fonction Nation" est sélectionnée dans l'onglet "Langues" de la description du projet.
  • WEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV Mobile 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.
Versions 21 et supérieures
Pour connaître la langue du système en cours, utilisez la fonction SysNation.
Nouveauté 21
Pour connaître la langue du système en cours, utilisez la fonction SysNation.
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'erreurs 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
14nationPortuguaisnationPortugais
Portugais
15nationPortuguaisBrésiliennationPortugaisBré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
42
Versions 16 et supérieures
nationAfrikaans
Nouveauté 16
nationAfrikaans
nationAfrikaans
Afrikaans
43
Versions 16 et supérieures
nationBengali
Nouveauté 16
nationBengali
nationBengali
Bengali
44
Versions 16 et supérieures
nationBiélorusse
Nouveauté 16
nationBiélorusse
nationBiélorusse
Biélorusse
45
Versions 16 et supérieures
nationCatalan
Nouveauté 16
nationCatalan
nationCatalan
Catalan
46
Versions 16 et supérieures
nationIndonésien
Nouveauté 16
nationIndonésien
nationIndonésien
Indonésien
47
Versions 16 et supérieures
nationMacédonien
Nouveauté 16
nationMacédonien
nationMacédonien
Macédonien
48
Versions 16 et supérieures
nationPendjabi
Nouveauté 16
nationPendjabi
nationPendjabi
Pendjabi
49
Versions 16 et supérieures
nationSindhi
Nouveauté 16
nationSindhi
nationSindhi
Sindhi
50
Versions 17 et supérieures
nationHindi
Nouveauté 17
nationHindi
nationHindi
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 pour la prochaine fenêtre ou page ouverte. Le changement sera effectif :
  • WINDEV immédiatement si l'option "Changement de langue immédiat après l'appel de la fonction Nation" est sélectionnée dans l'onglet "Avancé" de la description du projet. Si cette option n'est pas cochée, le changement de langue sera effectué pour la prochaine fenêtre ouverte. WINDEV immédiatement si l'option "Changement de langue immédiat après l'appel de la fonction Nation" est sélectionnée dans l'onglet "Langues" de la description du projet. Si cette option n'est pas cochée, le changement de langue sera effectué pour la prochaine fenêtre ouverte.
  • WEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV Mobile 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.Pour modifier la langue de la fenêtre ou de la page en cours, il est nécessaire de :
  • WINDEV cocher l'option "Changement de langue immédiat après l'appel de la fonction Nation" dans l'onglet "Avancé" de la description du projet. WINDEV cocher l'option "Changement de langue immédiat après l'appel de la fonction Nation" dans l'onglet "Langues" de la description du projet.
  • 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, celui-ci reste dans la langue choisie par défaut. Pour modifier la langue du menu, il est nécessaire de réafficher :
    • WINDEVWINDEV Mobile la fenêtre concernée avec la fonction Utilise après l'utilisation de la fonction Nation.
    • WEBDEV - Code Serveur la page concernée avec la fonction PageUtilise ou la fonction FramesetUtilise après l'utilisation de la fonction Nation.
  • Changement de langue par une option de menu : Si le changement de langue est effectué par une option du menu :
    • WINDEV le menu change automatiquement de langue si l'option "Changement de langue immédiat après l'appel de la fonction Nation" est cochée dans l'onglet "Avancé" de la description du projet. WINDEV le menu change automatiquement de langue si l'option "Changement de langue immédiat après l'appel de la fonction Nation" est cochée dans l'onglet "Langues" de la description du projet.
    • le menu reste dans la langue choisie par défaut. Pour modifier la langue du menu, il est nécessaire de réafficher :
      • WINDEVWINDEV Mobile la fenêtre concernée avec la fonction Utilise après l'utilisation de la fonction Nation.
      • WEBDEV - Code Serveur la page concernée avec la fonction PageUtilise ou la fonction FramesetUtilise après l'utilisation de la fonction Nation.
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.
WINDEV

Changement de langue et fichier d'aide

Sous l'éditeur d'aide de WINDEV, il est possible de construire le nom du fichier d'aide à partir d'un identifiant numérique correspondant à la fonction Nation.
Dans ce cas, pour lancer le fichier d'aide correspondant à la langue en cours, il suffit d'utiliser le code suivant :
// Lancement de l'aide au format CHM
WHelp("MonFichier" + Nation + ".chm")
WINDEV

Changement de langue et groupware utilisateur

Si vous utilisez le groupware utilisateur, les fenêtres spécifiques au groupware utilisateur sont livrées uniquement en 2 langues : le français et l'anglais.
Pour changer de langue dynamiquement, il est nécessaire d'effectuer une configuration spécifique du groupware utilisateur. Pour plus de détails, consultez Groupware utilisateur et multilingue.
Versions 24 et supérieures

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.
Nouveauté 24

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.

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 : wd240vm.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire