PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Multilingual project
  • Special case: Translating the windows and pages proposed by default
  • Including and translating the windows and pages proposed by default
  • Windows of AAF (Automatic Application Features)
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
Multilingual project
This table explains how to create and manage a multilingual project.
See Developing multilingual projects for more details.
Project elements
Project
Window, pages and controls (text, input masks and images)
Reports and controls

(text, display mask and images)
Help system

(hlp or chm)
Code messages (code, procedures, classes)
WINDEV messages
Action to perform
Choosing the different languagesThe project languages are selected in the project description ("Project .. Project description", "Languages" tab).
The project languages are selected in the project description:
1. On the "Project" pane, in the "Project" group, click "Description".
2. Select the "Languages" tab.

The selected languages are taken into account for all the closed elements.
The opened elements must be closed and re-opened.
Automatic if the language is managed in the project.
Windows shared among several applications that do not use the same languages: Select the additional language in the window description ("Language" tab).
Automatic if the language is managed in the project.
Reports shared between several applications that do not use the same languages: Select the additional language in the report description ("Language" tab).
Automatic if the language is managed in the project.
Help system shared between several projects that do not use the same languages: Select the additional language in the description of the help system ("Language" tab).
Automatic if the language is managed in the project.
Classes and procedures shared between several projects: Select the additional language in the language window (right click in the "Project explorer" pane, "Language" option).
Creating a new controlBy default, only the caption of runtime language is specified. The caption of the control must be translated into the supported languages.By default, only the caption of runtime language is specified. The caption of the control must be translated into the supported languages.The title of the new pages and the keywords are automatically created in English.
Translation without specific tool (in WINDEV directly)The translation must be performed in all description windows of windows and controls.The translation must be performed in all description windows of reports and controls.For the summary and the indexes: the translation must be performed in the description windows of the page.
For the content of the help page: the translation must be performed after the change of display language.
The translation must be performed in the message editor ([CTRL]+[T]).
Translating messages with WDMSG/WDINTCheck out all the messages to translate with WDMSG, translate the file generated by WDMSG and check in the translated messages.Check out and translate with WDINT. Generate a WDM file.
Display in the editor in a given languageChange the display language for all project elements: "Display .. Language displayed..."
Change the display language for all project elements: on the "Display" pane, in the "Options" group, expand "Language displayed"
Caution: the default runtime language of the project is not modified.
Automatic if the display language of project was modified.
To modify the display language for all project elements: "Display .. Language displayed..." (*)
To modify the display language for all project elements: on the "Display" pane, in the "Options" group, expand "Language displayed" (*)
Automatic if the display language of project was modified.
To modify the display language for all project elements: "Display .. Language displayed..." (*)
To modify the display language for all project elements: on the "Display" pane, in the "Options" group, expand "Language displayed" (*)
Automatic if the display language of project was modified
To modify the display language for all project elements: "Display .. Language displayed..." (*)
To modify the display language for all project elements: on the "Display" pane, in the "Options" group, expand "Language displayed" (*)
Automatic if the display language of project was modified.
To modify the display language for all project elements: "Display .. Language displayed..." (*)
To modify the display language for all project elements: on the "Display" pane, in the "Options" group, expand "Language displayed" (*)
TestThe project test is run in the default language of project.The window test is run in the default language of project.The report test is run in the default language of project.Compilation and test run in the display language of help system.
You must create as many help files as the number of languages.
During a test (window, project or report), message displayed in the default runtime language of project.Define the WDM file associated with each language in the project description ("Project .. Project description", "Languages" tab).
Define the WDM file associated with each language in the project description:
1. On the "Project" pane, in the "Project" group, click "Description".
2. Select the "Language" tab.
ExecutableCreated in the default project language.
To change this language as soon as the executable is run, call Nation in the initialization code of project.
Caution: the language will be modified from the call to Nation and until the next call to Nation.
Windows displayed in the executable language.
To change the display language of a window, use Nation before opening the window.
Caution: the language will be modified from the call to Nation and until the next call to Nation.
Reports printed in the default executable language.
To change the print language of a report, use:
Open the help file corresponding to the requested language (WHelp).Messages displayed in the current runtime language.
To change the language when displaying the message, use Nation.
Caution: the language will be modified from the call to Nation and until the next call to Nation.
Deployed siteCreated in the default project language.
To change this language as soon as the deployed site is run, call Nation in the initialization code of project.
Caution: the language will be modified from the call to Nation and until the next call to Nation.
Pages displayed in the project language.
To change the display language of a page, call Nation before opening the page.
Caution: the language will be modified from the call to Nation and until the next call to Nation.
Reports printed by default in the project language.
To change the print language of a report, use:
Messages displayed in the current runtime language.
To change the language when displaying the message, use Nation.
Caution: the language will be modified from the call to Nation and until the next call to Nation.
(*): if the caption of the control does not exist in the display language, the control appears empty in the editor.
Special case: Translating the windows and pages proposed by default
The following elements can be automatically included in your applications or sites:
  • WINDEV preview window.
  • HFSQL windows for automatic management of HFSQL programming errors.
  • WINDEVWEBDEV - Server code windows or pages of user groupware. These elements are used to manage the connection of a user to an application and the different access levels for each user.
  • WINDEV windows of AAF (Automatic Application Features).
  • WINDEVWEBDEV - Server code the setup program, allowing the user to install his application or his site.
Note: From version 19, HFSQL is the new name of HyperFileSQL.

Including and translating the windows and pages proposed by default

These windows and pages are available in French and in English by default. To support additional languages, the following operations must be performed:
HFSQL windows and pages
WINDEVWEBDEV - Server code Setup program
PurposePreview the report and allow the user to start the print on the requested support (printer, XML file, ...).Allow the user to manage the duplicate errors, the integrity errors, the password errors, the lock errors, ...Used to manage the connection of a user to an application as well as the different access levels for each user.Allow the user to install the application on his computer.
Integration in the projectAsk to include the windows in your project:
  1. Display the project description ("Project .. Project description").Display the project description: on the "Project" pane, in the "Project" group, click "Description".
  2. Display the "Style" tab.
  3. In the "Print preview" option, select "Custom".
  4. Select the type of customization to perform:
    • <Standard print preview (without skin template)>: this option imports the standard print windows into your project.
    • <Standard print preview to the skin template of the project>: this option imports the print windows corresponding to the skin template of your project.
Import into your project ("File .. Import") the files found in the directory:
On the "Project" pane, in the "Project" group, expand "Import" to import into your project the files found in the directory:
  • WINDEV "\Programs\Data\Preset windows\HyperFileSQL - Windows for automatic help".
  • Windows Mobile "\Programs\Data\Preset windows\HyperFileSQL - Windows for automatic help".
  • WEBDEV - Server code "\Programs\Data\Preset pages\HyperFileSQL - Pages for automatic help".
  • WINDEV "\Programs\Data\Preset windows\HFSQL - Windows for automatic help".
  • Windows Mobile "\Programs\Data\Preset windows\HFSQL - Windows for automatic help".
  • WEBDEV - Server code "\Programs\Data\Preset pages\HFSQL - Pages for automatic help".
Ask to include the windows in your project ("Workshop .. Configure the User Groupware .. Enable the management of user groupware .. Custom integration").
WINDEV Ask to include the windows in your project: on the "Project" pane, in the "Project" group, click "User groupware". Select "Custom user groupware".


WEBDEV - Server code Ask to include the pages in your project: on the "Project" pane, in the "Project" group, click "User groupware". Select "Enable the management of user groupware" and "Custom integration".
  • WINDEV Open and translate the WDSETUP project supplied with WINDEV.
  • WEBDEV - Server code Open and translate the WDSETUP project supplied with WINDEV.
Translation without any specific tool or with WDMSGSee the above table
Use in the selected languageAutomatic according to the default runtime language of the project.Automatic according to the default runtime language of the project.Automatic according to the default runtime language of the project.Automatic. All you have to do is configure the language used for the setup program in the setup wizard ("Workshop .. Create the setup procedure") or in WDINST ("Tools .. WDINST - Setup editor").
Automatic. All you have to do is configure the language used for the setup program:
  • in the setup wizard: on the "Project" pane, in the "Generation" group, expand "Setup procedure" and select "Create the setup procedure".
  • in WDINST: on the "Tools" pane, in the "Utilities" group, click "WDInst".

Caution: To use WDSetup in languages other than French or English, WDINST must be used to create the setup program.
Change the language with NationAutomaticAutomaticCancel the automatic run of the first groupware window ("Groupware .. Configure the user groupware").
Change the language with Nation (initialization code of the project for example).
Open the first groupware window with gpwOpen.
Cancel the automatic run of the first window or page found in the groupware:
  • On the "Project" pane, in the "Project" group, click "User Groupware".
  • WINDEV In the "Execution" tab, select "Manual run".
  • WEBDEV - Server code In the "General" tab, select "Manual start".
Change the language with Nation (initialization code of project for example).
Open the first window or page found in the groupware with gpwOpen.

Windows of AAF (Automatic Application Features)

Some AAFs (Automatic Application Features) are using specific windows. These windows can be included in the application to be translated. List of main features that require a specific integration in order to be translated:
Related Examples:
WD ChainedList Training (WINDEV): WD ChainedList
[ + ] This example supplies the tools required to build chained lists (simple sequencing). This type of list is used to store and browse a set of values in an organized way.

In the example, a chained list is used to store buttons.
- The list is then used to hide/move the buttons in the screen, creating a dynamic menu (Sidebar).
- The list is also used to translate the buttons without having to reload the window. To do so, the French caption and the English caption are stored for each button. The advantage of this method is to keep the status of the window, especially the menu in its drop-down aspect, the information text, and so on.

Specific feature of this example:
- this example is a multilingual example (French/English).
Minimum required version
  • Version 9
This page is also available for…
Comments
Example
//Define Language
IF Language = "Portuguese" //Brasil

LanguageToCharset(languagePortuguese,15)
Nation(nationBrazilianPortuguese)
ChangeCharset(charsetCurrent,languagePortuguese,15)

ELSE IF Language = "English" //Inglaterra

LanguageToCharset(languageEnglish,0)
Nation(nationEnglish)
ChangeCharset(charsetCurrent,languageEnglish,0)

ELSE IF Language = "Spanish" //Espanha

LanguageToCharset(languageSpanish,10)
Nation(nationSpanish)
ChangeCharset(charsetCurrent,languageSpanish,10)

ELSE

LanguageToCharset(languagePortuguese,15)
Nation(nationBrazilianPortuguese)
ChangeCharset(charsetCurrent,languagePortuguese,15)

END
BOLLER
Apr. 28 2017