ONLINE HELP
 WINDEV, WEBDEV AND WINDEV MOBILE
This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Controls, pages and windows / Multilingual functions
  • Managing the languages and the character set
  • Nation function and file of error messages
  • Identifier of languages
  • Changing language
  • Change of language and help file
  • Change of language and User Groupware
  • Changing languages and framework messages
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Defines or identifies the display language (captions, messages, ...) used for the windows, pages, reports and controls.
This function enables you to develop international applications that can be broadcast in several languages.
Example
WINDEVJavaUser code (UMC) 
// -- Choix menu: &Fichier..&Langues..&Anglais
// Changement de langue par menu
Nation(nationEnglish)
Use(FEN_MenuInt)
Syntax

Modifying the runtime language Hide the details

Nation(<Language number>)
<Language number>: Integer or Integer constant
Identifier of language to use (value defined in the project editor).  This identifier can be returned by GetCountryList.
The list of identifiers is specified in the Remarks.
The change will be effective:
  • WINDEV immediately if "Change language immediately after the call to WLanguage Nation function" is selected in the "Languages" tab of the project description.

Retrieving the number of the current language Hide the details

<Result> = Nation()
<Result>: Integer or Integer constant
Identifier of language currently used (see the Notes).
Remarks

Managing the languages and the character set

By default, captions and messages are displayed in the default language, which is selected in the "Languages" tab of the project description window ("Default language" in the context menu of the list of languages).
ChangeCharset allows you to find out and modify the character set used. When changing language (Nation), if the new language uses a different character set, this character set must be changed by ChangeCharset.
For more details, see Correspondence between languages, sub-languages, character sets and nations.
To change the language of current system, use SysNation.

Nation function and file of error messages

LoadError is used to load the error message file in the desired language.. This function is independent of Nation.
If an error file is available for each language supported by the application (or the site), this WDM file must be reloaded after each change of language performed by Nation.

Identifier of languages

The identifiers of languages are as follows:
IdentifierConstantLanguage
1nationGerman
German
2nationAmerican
American
3nationEnglish
English
4nationAustralian
Australian
5nationFrench
French
6nationDanish
Danish
7nationSpanish
Spanish
8nationFinnish
Finnish
9nationFrenchCanadian
French Canadian
10nationIcelandic
Icelandic
11nationItalian
Italian
12nationDutch
Dutch
13nationNorwegian
Norwegian
14nationPortuguese
Portuguese
15nationBrazilianPortuguese
Brazilian Portuguese
16nationRussian
Russian
17nationSwedish
Swedish
18nationCzech
Czech
19nationArabic
Arabic
20nationBosniac
Bosnian
21nationBulgarian
Bulgarian
22nationTraditionalChinese
Chinese
23nationChinese
Simplified Chinese
24nationKorean
Korean
25nationCroatian
Croatian
26nationEstonian
Estonian
27nationGreek
Greek
28nationHebrew
Hebrew
29nationHungarian
Hungarian
30nationIrish
Irish
31nationJapanese
Japanese
32nationLatvian
Latvian
33nationLithuanian
Lithuanian
34nationPolish
Polish
35nationRomanian
Romanian
36nationSerbian
Serbian
37nationSlovak
Slovakian
38nationSlovenian
Slovenian
39nationThai
Thai
40nationTurkish
Turkish
41nationVietnamese
Vietnamese
42nationAfrikaans
Afrikaans
43nationBengali
Bengali
44nationBelarusian
Belorussian
45nationCatalan
Catalan
46nationIndonesian
Indonesian
47nationMacedonian
Macedonian
48nationPunjabi
Punjabi
49nationSindhi
Sindhi
50nationHindi
Hindi
Custom languages
201
Language 1
202
Language 2
203
Language 3
204
Language 4
205
Language 5
206
Language 6
207
Language 7
208
Language 8
209
Language 9
210
Language 10
211
Language 11
212
Language 12

Changing language

  • Nation changes the runtime language.
    The change will be effective:
    • WINDEV immediately if "Change language immediately after the call to WLanguage Nation function" is selected in the "Languages" tab of the project description. If this option is not checked, the change of language will be performed when the next window is opened.
    After calling the function Nation, windows, pages, ... display titles, labels, ... in the requested language.
  • To modify the language of the current window or page, you must:
    • WINDEV check "Change language immediately after the call to WLanguage Nation function" in the "Languages" tab of the project description.
    • redisplay the relevant window (or page) with Use (or PageUse or FramesetUse), after the call to Nation.
  • Translation not found:
    If the translation of a window, page, message, etc. has not been carried out for the specified language (the element is not associated with that language), the preferred languages mechanism enables the desired information to be displayed in a language close to the one required.. For more details, see Managing the application language programmatically.
  • Changing language via a menu option:
    If the change of language is performed via a menu option:
    • WINDEV the menu language changes automatically if "Change language immediately after the call to WLanguage Nation function" is checked in the "Languages" tab of the project description.
    • the menu remains in the language selected by default. To modify the menu language, you must redisplay:
      • WINDEV the relevant window with Use after the call to Nation.
WINDEV

Change of language and help file

In the WINDEV help editor, the name of the help file can be built from a numeric identifier corresponding to Nation.
In this case, to start the help file corresponding to the current language, all you have to do is use the following code:
// Lancement de l'aide au format CHM
WHelp("MonFichier" + Nation + ".chm")
WINDEV

Change of language and User Groupware

If you're using User Groupware, windows specific to User Groupware are only available in 2 languages: English and French.
To change the language dynamically, you must configure the User Groupware specifically. For more details, see User Groupware and multilingual feature.

Changing languages and framework messages

The framework language automatically adapts to the application language defined by Nation. For example: 
Nation(nationFrench) // framework en français 
Nation(nationFrenchCanadian) // framework en français
Nation(nationSpanish) // framework en espagnol
Nation(nationCatalan) // framework en espagnol
// Autres cas: 
// Nation(nationxxx): framework anglais
NationFramework allows you to force the use of one of the languages for the framework.
Component: wd300vm.dll
See also
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/24/2024

Send a report | Local help