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 your 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 menu and click Next button on the first page of appeared Wizard.
  • Select main form 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 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 Translation Editor.
TsiLang Translation Editor

TsiLang Translation Editor

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

  • Click File|Close Saved in Translation Editor menu.
  • 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 File|Source|With Form in TsiLang Expert’s menu.

Translating DBGridstop

For translating TDBGrids:

  • Add the necessary fields in the TDataSet fields editor.
  • Select File|Translate in 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 Translation Editor menu.
  • Also you can translate grids without adding fields by using Collections property and translate 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!