HomePowerBuilderAppeon Documentation Center

SetLanguage

Description

Sets the language of PowerBuilder runtime text resources.

Syntax

integer SetLanguage (LanguageType type)

Argument

Description

type

A value of LanguageType enumerated type that specifies the language type.

Value can be one of the following:

  • Chinese!

  • Custom! -- the user-defined language

  • Danish!

  • Dutch!

  • English!

  • French!

  • German!

  • Italian!

  • Japanese!

  • Norwegian!

  • Spanish!

  • Swedish!

  • WindowsLanguage! -- uses the same language as the "Windows Display Language" setting configured for the current user on the client.

    Some Windows display languages have multiple locales, for example, Chinese has Chinese (Simplified, China), Chinese (Simplified, Singapore), Chinese (Traditional, Hong Kong SAR), Chinese (Traditional, Macao SAR), and Chinese (Traditional, Taiwan), and all of them will be mapped to the supported language type -- Chinese; for another example, English has English (Australia), English (Belize), ..., and English (Zimbabwe), and all of them will be mapped to the supported language type -- English; and other languages are similar.

    If the Windows display language is not one of the language types supported by PowerBuilder Runtime, English (for EN version) or Japanese (for JP version) will be used by default.


Return value

Integer.

1 – Success;

-1 – Language file does not exist;

-2 – Language file open failed;

-3 – Language file read failed.

Usage

The runtime text resource displays in the new language immediately after SetLanguage is executed.

If you call SetLanguage in your application to set the language type, the application will use the set language type; if the language package file corresponding to the language type is invalid, SetLanguage will fail and return an error code.

If the language type is WindowsLanguage!, the Windows Display Language of the client will be used by PowerBuilder Runtime; if the Windows display language is not one of the language types supported by PowerBuilder Runtime, English (for EN version) or Japanese (for JP version) will be used by default.

If the language type is Custom!, the user-defined language will be used. Only one custom language file is allowed, and must be named custom.lng and placed in the runtime language folder, for example, C:\Program Files (x86)\Appeon\Common\PowerBuilder\Runtime 25.1.0.6180\lang. File format is TextID, TextDescription. Edit only the text descriptions.

Examples

This example sets the language type to the Windows display language of the current client. This is the recommended way.

If the Windows display language is not supported, English (for EN version) or Japanese (for JP version) will be used. 

integer li_rtn
li_rtn = SetLanguage(WindowsLanguage!)

Alternatively, you can use GetEnvironment to get the Windows display language first and then set the language type. If the Windows display language is not one of the language types supported by PowerBuilder Runtime, GetEnvironment returns languageEnglish! (for EN version) or languageJapanese! (for JP version). 

environment lenv
LanguageType lt_lang
Integer li_rtn

GetEnvironment(lenv)

Choose Case lenv.Language
       Case languageEnglish!
              lt_lang = English!
                     
       Case languageFrench!
              lt_lang = French!
              
       Case languagegerman!
              lt_lang = German!
              
       Case languageDutch!
              lt_lang = Dutch!
              
       //other supported language types
       ...
       Case Else
              lt_lang = English!
End Choose

li_rtn = SetLanguage(lt_lang)

This example sets the language type to French.

integer li_rtn
li_rtn = SetLanguage(French!)

See also

GetLanguage

Prev  Up  Next
SetJWTToken  Home  SetLargeButton