|
|
|
|
|
|
|
|
|
|
- Adapting a project to support multiple languages
- 1. Choosing the different languages
- 2. Creating a new control
- 3. Translation without specific tool (in WINDEV directly)
- 3 b. Translating messages with WDMSG/WDINT
- Display in the editor in a given language
- Test
- Executable
- Deployed site
- Special case: Translating the windows and pages proposed by default
- Including and translating the windows and pages proposed by default
- Report viewer
- HFSQL windows and pages
- User Groupware
- Setup program
- Windows of AAF (Automatic Application Features)
Adapting a project to support multiple languages This page presents the main steps to make your projects support multiple languages: 1. Choosing the different languages | | | You can select the languages of the project in the project description:- On the "Project" tab, in the "Project" group, click "Description".
- Select the "Languages" tab and click "Add".
- The selected languages are taken into account for all elements (open elements are automatically closed).
| - Windows, pages, reports and controls (text, input masks and images)
| The different project languages are automatically managed.
Elements shared between projects that use different languages: when the element is opened in one of the projects, the additional languages are automatically added. | | The different project languages are automatically managed.
Help systems shared between projects that use different languages: when the element is opened in one of the projects, the additional languages are automatically added. | - Messages in the code (code, procedures, classes)
| The different project languages are automatically managed.
Classes and procedures shared between projects: when the element is opened in one of the projects, the additional languages are automatically added. . |
2. Creating a new control | | - Windows, pages, reports and controls (text, input masks and images)
| 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. |
3. Translation without specific tool (in WINDEV directly) | | - Windows, pages, reports and controls (text, input masks and images)
| Text must be translated in all window, page, report and control descriptions. | | For the summary and the indexes: the translation must be performed in the description windows of the page.
For the content of help page: the translation must be performed after the change of display language. | - Messages in the code (code, procedures, classes)
| The translation must be performed in the message editor (Ctrl + T). |
3 b. Translating messages with WDMSG/WDINT | | - Windows, 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)
| Extract all messages to be translated with WDMSG, translate the generated file and reintegrate the translations. | | Extract and translate with WDINT. Generate a WDM file. |
Display in the editor in a given language | | | Change the display language for all project elements: on the "Display" tab, in the "Options" group, expand "Language displayed"
Caution: the default runtime language of project is not modified. | - Windows, pages and controls (text, input masks and images)
| The language of the editor changes automatically according to the language of the project.
To modify the display language for all project elements: on the "Display" tab, in the "Options" group, expand "Language displayed" (*) | - Reports and controls (text, display mask and images)
| The language of the editor changes automatically according to the language of the project.
To modify the display language for all project elements: on the "Display" tab, in the "Options" group, expand "Language displayed" (*) | | The language of the editor changes automatically according to the language of the project
To modify the display language for all project elements: on the "Display" tab, in the "Options" group, expand "Language displayed" (*) | - Messages in the code (code, procedures, classes)
| The language of the editor changes automatically according to the language of the project.
To modify the display language for all project elements: on the "Display" tab, in the "Options" group, expand "Language displayed" (*) |
Test | | | The test of the project is run using the language selected as "Default language at runtime". The default language used at runtime is selected in the project description window ("Languages" tab). | - Windows, pages and controls (text, input masks and images)
| The window test is run in the default language of the project. | - Reports and controls (text, display mask and images)
| The report is tested in the default language of the project. | | Compilation and test run in the display language of help system.
You must create as many help files as the number of languages. | - Messages in the code (code, procedures, classes)
| When testing a window or project, the messages from the code are displayed in the default language of the project. | | Define the WDM file associated with each language in the project description:- On the "Project" tab, in the "Project" group, click "Description".
- Select the "Language" tab.
- Select the desired language.
- On the "Miscellaneous" tab, select the WDM translation file.
|
Executable | | | The executable is created in the default language of the project.
To change this language as soon as the executable is run, use Nation in the initialization code of the project.
Caution: the language will be modified from the call to Nation and until the next call to Nation. | - Windows, pages and controls (text, input masks and images)
| The windows are displayed in the language of the executable.
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 and controls (text, display mask and images)
| The reports are printed by default in the language of the executable.
To change the print language of a report, use:- Nation before printing the report.
Caution: the language will be modified from the call to Nation and until the next call to Nation. - the iPrintingNation function.
- Help system (hlp or chm):
Open the help file corresponding to the desired language (WHelp).
| - Messages in the code (code, procedures, classes)
| Messages are displayed in the current runtime language.
To change the language used to display the message, use Nation.
Caution: the language will be modified from the call to Nation and until the next call to Nation. | | Define the WDM file associated with each language in the project description:- On the "Project" tab, in the "Project" group, click "Description".
- Select the "Language" tab.
|
Deployed site | | | The site is deployed in the default language of the project.
To change this language as soon as the deployed site is run, use Nation in the initialization code of the project.
Caution: the language will be modified from the call to Nation and until the next call to Nation. | - Windows, pages and controls (text, input masks and images)
| Pages are displayed in the language of the project.
To change the display language of a page, use Nation before opening the page.
Caution: the language will be modified from the call to Nation and until the next call to Nation. | - Reports and controls (text, display mask and images)
| By default, reports are printed in the language of the project.
To change the print language of a report, use: | - Messages in the code (code, procedures, classes)
| Messages are displayed in the current runtime language.
To change the language used to display the message, use Nation.
Caution: the language will be modified from the call to Nation and until the next call to Nation. |
Special case: Translating the windows and pages proposed by default The following elements can be automatically included in your applications or sites: - HFSQL windows for automatic management of HFSQL programming errors.
 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. - the setup program, allowing the user to install his application or his site.
Including and translating the windows and pages proposed by default These windows and pages are available in English and French by default. To support additional languages, the following operations must be performed: Report viewer | | | Display the report in "Preview" mode, and allow the user to print via the desired medium (printer, XML file, etc.). | - Integration into the project
| Request the integration of windows in your project:- Open the project description: on the "Project" tab, in the "Project" group, click "Description".
- Go to the "Style" tab.
- In "Report viewer", select "Custom (included in the project)".
- Select the type of customization to perform:
- <Standard report viewer (without skin template)>: this option imports the standard print windows into your project.
- <Standard report viewer with the skin template of the project>: this option imports the print windows corresponding to the skin template of your project.
| - Translation with WDMSG, or without specific tools
| See previous paragraph. | | The runtime language of the project will be used by default. | - Change of language with Nation
| The language changes automatically.. |
HFSQL windows and pages | | | Allow the user to manage duplicate errors, integrity errors, password errors, lock errors, etc. | - Integration into the project
| On the "Project" tab, in the "Project" group, expand "Import" to import the files located in this directory:- "\Programs\Data\Preset Pages\EN\HyperFileSQL - Automatic Help Windows".
| - Translation with WDMSG, or without specific tools
| See previous paragraph. | | The runtime language of the project will be used by default. | - Change of language with Nation
| The language changes automatically.. |
User Groupware | | | Used to manage the connection of a user to an application as well as the different access levels for each user. | - Integration into the project
|
| - Translation with WDMSG, or without specific tools
| See previous paragraph. | | The runtime language of the project will be used by default. | - Change of language with Nation
| Cancel the automatic start of the first window or page from the groupware:- On the "Project" tab, in the "Project" group, click "User Groupware".
- In the "General" tab, select "Manual start".
Change the language with Nation (e.g. project initialization code).
Open the first window or page found in the groupware with gpwOpen. |
Setup program | | | Allow the user to install the application on his computer. | - Integration into the project
| - Open and translate the WDSETUP project provided with WINDEV.
| - Translation with WDMSG, or without specific tools
| See previous paragraph. | | The language is automatically selected. Simply configure the language used for the setup program:- in the setup wizard: on the "Project" tab, in the "Generation" group, expand "Setup procedure" and select "Create setup procedure".
- in WDInst: on the "Tools" tab, 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. |
Windows of AAF (Automatic Application Features) Some AAFs (Automatic Application Features) use 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:
|
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).
|
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|