Features overview

Here is the overview of important or interesting features of the Precision Language Suite product.

Benefits of used implementation and the file format

• Precision Language Suite allows you to implement the localization for your product in only four easy steps
• Text format of language files is very clear
• It allows great flexibility and dynamic use if required
• Quick adaptation to specific customer requirements without altering the distribution image of the product
• Sharing the language files between projects (products)
• Fast and uncomplicated verification of changes during development
• Product allows error messages localization of the third-party libraries
• Basic system dialogs are part of supplied source code

Four steps to localize your application

To get an idea of how to localize your application, read the following procedure. The more detailed description can be found in the product help.

1. Create an instance of TLanguageManager class
   

   Use the unit plsLangMan anywhere in the project. This unit initializes a global LanguageManager variable of the class TLanguageManager.

   Now assign a language code value to the LanguageManager.LanguageCode property.

   TLanguageManager supports also other options, such as filtering the names of used language files (FileNames), location of the language files folder (Folder), and more.

2. Determine a list of available languages and present it to the user
   

   To get a list of available languages, use a method LanguageManager.GetAvailableLanguages. It fills the specified list with values in the format "language_code = language_name".

   This list can be presented to the user in the form of menu items, or in any other chosen form. When a user switches the language, you need to simply assign selected language code to the LanguageManager.LanguageCode property.

3. Define OnLanguageChanged event
   

   The method assigned to the LanguageManager.OnLanguageChanged event is very important when you want to change the language during the application run.

   

   It serves not only to change the localization of components on the form, but also as a central method to change the language in all active forms, data modules and other components of the application.

   Setting localized texts of chosen language to the components on the form is ensured simply by calling the method LanguageManager.LangVCL.

4. Choose your way to use the text constants
   

   The ideal way to use localized text strings (constants) is to let the Editor of localization projects generate a special source file (ie. LangConsts.pas) for you.

   Editor will create all the necessary declarations, LanguageChanged method and default text assignments, so everything what you have to do, is using the constants identifiers when you need them.

   However, if you want, you can access the constants with the help of LanguageManager.LangText method. This method may return not only constant texts, but also a property values of VCL Components from the current language.

About the Editor

Although you can define a language files of your products in an ordinary text editor, specialized tool always will provide much more comfort and better ergonomy, what is mainly appreciated in the preparation of larger projects. And when any new functionality is added to the "localization source codes", this editor is updated simultaneously with them.

Editor features

• List of your projects
• Quick searching and filtering of items
• Finding and replacing the texts
• Automatic synchronization with defined VCL forms
• Insertion of selected components from Delphi to the localization project (via the clipboard)
• Automatic generation of the source file for the text constants identifiers (including the default texts)
• Suggestions of localization source code for your application
• Support for translation into other languages using web services
• The package system for defining the default constants, messages, supported properties, etc.

Creating a new project with the Editor

When creating a localization (language) files for your product, you can use the following tentative procedure. The more detailed description can be found in the editor help.

• Create a new localization project at any time during the development process of your product
• Add new languages to the project by selecting from the predefined list
• Add VCL components for the localization (by manual addition of identifiers, by copying the components in Delphi and pasting them into the project from clipboard, or by adding the VCL file links into the localization project)
• Add text constants
• Localize the system messages
• Translate your texts
• Save the project and now you can use the resulting language files in your product

Embedded localization feature

Besides the standard possibilities of localization, the Precision Language Suite offers an embedded localization feature, that allows you to define localized texts directly in your running application.

You can simply click the elements in your application and enter the captions and texts in the currently selected language. This feature is suitable for minor corrections, as well as for a complex localization by an external translator, or also (in the so called UserMode) for your end users.

Althought this feature is available for registered users only (users with the purchased license of localization editor), the compiled demo applications are part of the distribution package, that is freely available for download. So any user can try the basic possibilities of an embedded localization feature of Precision Language Suite.

How embedded localization works?

Standard implementation of this feature is as follows:

• Into the main form of your project add the units plsLangMan and plsEmbedded
• Into FormCreate event, add a line of code, that installs a keyboard shortcut for begin the capturing of components to localize:
  LE_InstallCaptureControlShortcut(LanguageManager,TextToShortcut('Alt+F2'));
  
• Into FormClose event, add a line of code, that removes this keyboard shortcut:
  LE_RemoveCaptureControlShortcut;
  

And that's all folks! Now your product allows user to modify a component labels and other text strings, including the saving into the localization files.

To load back a newly entered texts, you have to implement also the standard localization functions. Along with these standard options of localization, you can change the texts in the currently selected language of user interface and make the corrections, or to enter labels of components "from scratch".

Of course, the installation and usage of "embedded localization" feature can be conditionally defined, ie. by command-line switch, by menu option, or completely separated by compilation directive.

In the plsEmbedded unit, there are also other methods, functions and variables, that can be used to setup a behaviour and the look of "embedded localization" feature.

Customization of embedded localization feature

Screenshots on this web site and the product demonstration projects present a default appearance and the behaviour of "embedded localization" dialog. Globaly defined variables and methods in plsEmbedded unit, allow you to customize the behaviour in many ways, and by implementing your own code in the plsEmbedded unit, you can completely rewrite the functionality and the look and feel of this feature. Source codes that support an "embedded localization" (plsEmbedded unit) you gain together with a purchased Precision Language Suite product license (see License agreement).

Other possibilities

As was mentioned above, an "embedded localization" is suitable for minor corrections, as well as for a complex localization by an external translator. But an interesting option is the combination of this feature along with the user language files format, because by this way you can provide an easy to use tool localization tool for your end-users. They can create their own localizations (themes or profiles resp.), and this without a risk, that it would have been overwritten a distribution localization files (whether on the client side or on your side, when you will take back and test such a translation).

All available informations and description of embedded localization feature can be found in the product help reference.