• prompt the user to choose the runtime language the first time the application is started,
• include an option (menu option or button, for example) to allow users to change the language while the application is running.

Default language

• on the "Project" tab, in the "Project" group, click "Description".
• select the "Languages" tab.
• select the default language in the list of project languages and select "Default language" in the context menu.

Changing the language programmatically

1. Call Nation and pass the selected language as parameter. The selected language will be taken into account by the first WLanguage function called after Nation and for all the windows, pages and reports that will be opened thereafter.
2. Call LoadError to load the message error file of the components (WD*.DLL files) in the selected language. The error message file has a WDM extension.
   Remarks:
   • If a message file is associated with the language chosen in the project description, there is no need to use LoadError.
     Reminder The message file is defined in the "Miscellaneous" tab of the project description.
     Reminder: to display the project description, under the "Project" pane, in the "Project" group, click on "Description". Select the "Languages" tab.
   • The error messages of the components are in English by default. They can be translated with WDINT.EXE. WDINT is an additional tool. Contact PC SOFT Sales Department for more details about the conditions for using this program.
3. If your application manages languages using specific character sets (Greek, Korean, etc.)change by programming:
   • the character set used (ChangeCharset). This character set can also be used for the data saved in the HFSQL data files. For more details, see Managing specific character sets in the data files.
   • the language of the keyboard used by the application users (ChangeKeyboard).

// La langue est choisie avec le sélecteur SEL_ChoixLang
SWITCH SEL_ChoixLang
	CASE 1 : // Français
		Nation(nationFrench)
	CASE 2 : // Anglais
		Nation(nationEnglish)
		IF LoadError("ANGLAIS.WDM") > 0 THEN
			Error("Fichier des messages non trouvé. ",...
				"Les messages seront affichés en français.")
		END
	CASE 3 : // Espagnol
		Nation(nationSpanish)
		IF LoadError("ESPAGNOL.WDM") > 0 THEN
			Error("Fichier des messages non trouvé. ",...
			"Les messages seront affichés en français.")
		END
	CASE 4 : // Grec
		Nation(nationGreek)
		IF LoadError("GREC.WDM") > 0 THEN
			Error("Fichier des messages non trouvé. ",...
			"Les messages seront affichés en français.")
		END
		ChangeCharset(charsetGreek)
		ChangeKeyboard(charsetGreek)
END

To change the language through programming, simply call Nation with the selected language as parameter. The selected language will be taken into account by the first WLanguage function called after Nation and for all the windows that will be opened thereafter.

Tip

• Stored in a parameter file. In this case, the change of language can be performed in the initialization process of the project and it will effective from the first window or page of the project.
• Chosen by a menu option. In this case, the menu will be displayed in the default language and the change of language will be performed when the next window or page is opened.