PC SOFT

ONLINE HELP
 WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • Managing the languages and the character set
  • Nation function and file of error messages
  • Identifier of languages
  • Changing language
  • Change of language and AWP page
  • Changing languages and framework messages
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Defines or identifies the display language (captions, messages, ...) used for the windows, pages, reports and controls.
This function allows you to develop international applications that can be distributed in several languages.
Versions 15 and later
PHP This function is now available for PHP sites.
New in version 15
PHP This function is now available for PHP sites.
PHP This function is now available for PHP sites.
Example
Reports and QueriesJavaUser code (UMC)
// -- Menu choice: &File..&Languages..&English
// Change the language via a menu
Nation(nationEnglish)
Use(WIN_IntMenu)
PHPAjax
// -- Menu choice: &File..&Languages..&English
// Change the language via a menu
Nation(nationEnglish)
// Redisplay the home page
PageUse(PAGE_HomePage)
Ajax
// AWP pages without context
 
// Code of the button with an English flag
ScriptDisplay("../UK/Home.awp")
 
// Code of button with French flag
ScriptDisplay("../FR/Home.awp")
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).  
Versions 21 and later
This identifier can be returned by GetCountryList.
New in version 21
This identifier can be returned by GetCountryList.
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 popup 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 is using a different character set, this character set must be changed by ChangeCharset.
    For more details, see Correspondence between languages, sublanguages, character sets and nations.
    Versions 21 and later
    To change the language of current system, use SysNation.
    New in version 21
    To change the language of current system, use SysNation.
    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
    42
    Versions 16 and later
    nationAfrikaans
    New in version 16
    nationAfrikaans
    nationAfrikaans
    		Afrikaans
    43
    Versions 16 and later
    nationBengali
    New in version 16
    nationBengali
    nationBengali
    		Bengali
    44
    Versions 16 and later
    nationBelarusian
    New in version 16
    nationBelarusian
    nationBelarusian
    		Belorussian
    45
    Versions 16 and later
    nationCatalan
    New in version 16
    nationCatalan
    nationCatalan
    		Catalan
    46
    Versions 16 and later
    nationIndonesian
    New in version 16
    nationIndonesian
    nationIndonesian
    		Indonesian
    47
    Versions 16 and later
    nationMacedonian
    New in version 16
    nationMacedonian
    nationMacedonian
    		Macedonian
    48
    Versions 16 and later
    nationPunjabi
    New in version 16
    nationPunjabi
    nationPunjabi
    		Punjabi
    49
    Versions 16 and later
    nationSindhi
    New in version 16
    nationSindhi
    nationSindhi
    		Sindhi
    50
    Versions 17 and later
    nationHindi
    New in version 17
    nationHindi
    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 the call to Nation, the windows, the pages, ... display the titles, the captions, ... in the requested language.
      • To modify the language of the current window or page, you must:
      • Translation not found:
        If the translation of a window, page, message, ... was not performed for the specified language (the element is not associated with this language), the mechanism of preferred languages displays the information in a language close to the desired one. See Managing the application language by programming for more details.
      • 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:
        Ajax

        Change of language and AWP page

        To change the language of an AWP page, you must use Nation and display the desired AWP page.
        Versions 24 and later

        Changing languages and framework messages

        The framework language automatically adapts to the application language defined by Nation. For example:
        Nation(nationFrench) // framework in French
        Nation(nationFrenchCanadian) // framework in French
        Nation(nationSpanish) // framework in Spanish
        Nation(nationCatalan) // framework in Spanish
        // Other case:
        // Nation(nationxxx): framework in English
        NationFramework allows you to force the use of one of the languages for the framework.
        New in version 24

        Changing languages and framework messages

        The framework language automatically adapts to the application language defined by Nation. For example:
        Nation(nationFrench) // framework in French
        Nation(nationFrenchCanadian) // framework in French
        Nation(nationSpanish) // framework in Spanish
        Nation(nationCatalan) // framework in Spanish
        // Other case:
        // Nation(nationxxx): framework in English
        NationFramework allows you to force the use of one of the languages for the framework.

        Changing languages and framework messages

        The framework language automatically adapts to the application language defined by Nation. For example:
        Nation(nationFrench) // framework in French
        Nation(nationFrenchCanadian) // framework in French
        Nation(nationSpanish) // framework in Spanish
        Nation(nationCatalan) // framework in Spanish
        // Other case:
        // Nation(nationxxx): framework in English
        NationFramework allows you to force the use of one of the languages for the framework.
        Component: wd260vm.dll
        See also
        Minimum version required
        • Version 9
        This page is also available for…
        Comments
        Click [Add] to post a comment