Contents

Installation (Trial Version)

Installation (Registered Version)

Implementing localization

Translating strings in source code

Translating DBGrids

With TsiLang and the TsiLang Expert that comes with it, you can translate your project as quickly and easily as you play your favorite game.

Installation (Trial Version)top

  • Close all running instances of RAD Studio, Delphi or C++ Builder.
  • Run TsiLangTrialSetup.exe and follow the instructions.
  • Once the installation script is completed the TsiLang Components Suite will be automatically installed into selected IDE(s).

Installation (Registered Version)top

Note: If you have previously installed a trial copy of the TsiLang Components Suite, uninstall it from your PC. Make sure all its files are deleted.

  • Close all running instances of RAD Studio, Delphi or C++ Builder.
  • Run SISETUP.EXE (SIBINARY.EXE in case of DCU-Only Edition) and follow the instructions. The installation script will install source files to destination folder and adjust library path for the selected IDE(s).
  • Once the installation script is completed the TsiLang Components Suite will be automatically installed into selected IDE(s).

Implementing localization / multilanguage supporttop

Note: The translation example below is a simplified sample and was used just for demonstration.

Implementing localization / multilanguage support in your project:

  • Open a project for translating.
  • Select Tools|TsiLang Expert in the IDE’s main menu. (TsiLang Expert is an powerful tool that will help you to translate your project in one-two mouse-clicks.)
TsiLang Expert

TsiLang Expert

  • Select File|Wizard in TsiLang Expert’s ribbon and click Next button on the first page of the appeared Wizard.
  • Select the main form of the project and set TsiLang type in the combo-box at the right. For all other forms in the list set TsiLangLinked.
Translation Wizard. Step 1

Translation Wizard. Step 1

  • Set the settings as presented on the picture below and click Next button.
Translation Wizard. Step 2

Translation Wizard. Step 2

  • After Wizard completed double-click on the form in the TsiLang Expert to open the Translation Editor.
TsiLang Translation Editor

TsiLang Translation Editor

Enter the translations for the necessary elements. If certain components property should not change, just leave the corresponding language field empty.

  • Click File|Close Saved in the Translation Editor’s ribbon.
  • Insert a line of code for changing the active language into the source file. In Delphi, it will be something like this:
procedure TMainForm.MenuItemGermanClick(Sender: TObject);
begin
  siLangDispatcher1.ActiveLanguage := 2;
end;

procedure TMainForm.MenuItemEnglishClick(Sender: TObject);
begin
  siLangDispatcher1.ActiveLanguage := 1;
end;

Translating strings in source codetop

TsiLang Expert can analyze your source file, collect and translate strings and string constants used in your source code. Just select Strings in Source|With Form in TsiLang Expert’s ribbon.

Translating DBGridstop

For translating TDBGrids:

  • Add the necessary fields in the TDataSet fields editor.
  • Select File|Translate in the TsiLang Expert’s menu.
  • In the appeared Translation Editor select DisplayLabels node in the translations tree.
  • Enter the values for corresponding fields’ DisplayLabel property.
  • Click File|Close in the Translation Editor’s ribbon.
  • Also you can translate grids without adding fields but by using the Collections property of the TsiLang and translate the Columns property of the grid.

And finally,

compile your project. You are ready to distribute your multilingual application and receive new sales from new regional markets!