Contents

Installation (Trial Version)

Installation (Registered Version)

Implementing localization

Translating strings in source code

Translating DBGrids

With TsiLang and the included TsiLang Expert, 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 finished, TsiLang Components Suite will be automatically installed into the selected IDE(s).

Installation (Registered Version)top

Note: If you have previously installed a trial version of the TsiLang Components Suite, uninstall it from your PC. Make sure that 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 finished, TsiLang Components Suite will be automatically installed into the selected IDE(s).

Implementing localization / multilanguage supporttop

Note: You can watch a detailed demo-video at the following URL: https://www.sicomponents.com/video-tsilang-live-demo/

Note: The translation example below is a simplified example used for demonstration purposes only.

Implementing localization / multilanguage support in your project:

  • Open a project for translating.
  • Select Tools|TsiLang Expert from the main menu of the IDE. (TsiLang Expert is a powerful tool that will help you translate your project in one or two clicks).
TsiLang Expert

TsiLang Expert

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

Translation Wizard. Step 1

  • Specify the settings as shown in the figure below and click Next.
Translation Wizard. Step 2

Translation Wizard. Step 2

  • After the wizard is finished, double-click the form in the TsiLang Expert to open the Translation Editor.
TsiLang Translation Editor

TsiLang Translation Editor

Enter the translations for the required elements. If you do not want certain component properties to change, simply leave the corresponding language field blank.

  • On the command panel of the Translation Editor, click File|Close Saved.
  • Add a line of code to change the active language in the source file. In Delphi it will look 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 command panel.

Translating DBGridstop

To translate 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 the DisplayLabels node in the translations tree.
  • Enter the values for the DisplayLabel property of the corresponding fields.
  • Click File|Close Saved in the Translation Editor’s command panel.
  • You can also translate grids without adding fields, but by using the Collections property of TsiLang and translating the Columns property of the grid.

And finally,

compile your project. You are ready to deploy your multilingual application and generate new revenue from new regional markets!