Nation (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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
Changing languages and framework messages

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Nation (Function)

In french: Nation

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

// -- 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:

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:

Identifier	Constant

1	nationGerman	German
2	nationAmerican	American
3	nationEnglish	English
4	nationAustralian	Australian
5	nationFrench	French
6	nationDanish	Danish
7	nationSpanish	Spanish
8	nationFinnish	Finnish
9	nationFrenchCanadian	French Canadian
10	nationIcelandic	Icelandic
11	nationItalian	Italian
12	nationDutch	Dutch
13	nationNorwegian	Norwegian
14	nationPortuguese	Portuguese
15	nationBrazilianPortuguese	Brazilian Portuguese
16	nationRussian	Russian
17	nationSwedish	Swedish
18	nationCzech	Czech
19	nationArabic	Arabic
20	nationBosniac	Bosnian
21	nationBulgarian	Bulgarian
22	nationTraditionalChinese	Chinese
23	nationChinese	Simplified Chinese
24	nationKorean	Korean
25	nationCroatian	Croatian
26	nationEstonian	Estonian
27	nationGreek	Greek
28	nationHebrew	Hebrew
29	nationHungarian	Hungarian
30	nationIrish	Irish
31	nationJapanese	Japanese
32	nationLatvian	Latvian
33	nationLithuanian	Lithuanian
34	nationPolish	Polish
35	nationRomanian	Romanian
36	nationSerbian	Serbian
37	nationSlovak	Slovakian
38	nationSlovenian	Slovenian
39	nationThai	Thai
40	nationTurkish	Turkish
41	nationVietnamese	Vietnamese
42	nationAfrikaans	Afrikaans
43	nationBengali	Bengali
44	nationBelarusian	Belorussian
45	nationCatalan	Catalan
46	nationIndonesian	Indonesian
47	nationMacedonian	Macedonian
48	nationPunjabi	Punjabi
49	nationSindhi	Sindhi
50	nationHindi	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:
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:
- 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:
- the menu remains in the language selected by default. To modify the menu language, you must redisplay:

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