Initializing the NLS Translation
To get the NLS Translation available in your Python script, you have to define different settings by calling the defineNLS() Method.
It provides several parameters for getting the desired translation.
defineNLS( language, project, alternativePath )
Parameter language : can be set with the usual E2 languages english “EN”, german “DE”, french “FR”, chinese “CN”, japanese “JP”
If left empty "" the class tries to get the OSystem lanuage and link to this language. Default is english “EN”
Parameter project : a desired name for the translation files can be set. If left empty "", by default “common” will be use.
Means, that the class is searching for translation files with the desired name (or “common”)
The file naming convention is [name].[language].lng, e.g. report.fr.lng
Parameter alternativePath : by default the class searches for language files in the E2 installation cenpylib folder, subfolder languages.
If customized files needed, no matter if already existing in the cenpylib folder or complete new ones, a path to a desired PlugIn can be defined.
defineNLS() : no Args : get language from OS, Project “common”, NLS in cenpylib\languages
defineNLS(language) : only language Arg : desired language, Project “common”, NLS in cenpylib\languages
defineNLS(altpath=“yourpath”) : only path Arg : get language from OS, Project “common”, NLS in altpath & cenpylib\languages
defineNLS(language, altpath=“yourpath”) : language & path Arg : desired language, Project “common”, NLS in altpath & cenpylib\languages
defineNLS(language, project) : language & project Arg : desired language or empty ""=OS, Project with desired Name, NLS in cenpylib\languages
defineNLS(language, project, altpath) : language & project Arg : desired language or empty ""=OS, Project with desired Name, NLS in altpath & cenpylib\languages
defineNLS(project=“yourproject”, altpath=“yourpath”) : language=OS, Project with desired Name, NLS in altpath & cenpylib\languages
Note : be aware that in some cases the parameter description (altpath=”…”) might be needed
Default location of translation files :
Customized location, files beside the Python script
Language getting from the operating system, project name “mytrans”, search in path of the caller script
When using an alternative path with language files that are already existing in the cenpylib folder, the class searches first in the alternative folder for the item, then in the cenpylib folder.
