1. Assignment.
2. Features.
3. What do you need to localize your application.
4. Description and using DelLoc.
5. Description of the LcUnit.pas.
6. Demo-project.
7. Parts.
8. License agreement.
9. Download (version 2.51 and 3.00 for DelphiXE).
10. About author.

1. Assignment.

"DelLoc" (Delphi localization compiler) lets You to localize delphi application to any languages. You can translate string constans included in the resourcestring blocks and any string properties of the project forms and components.

2. Features.

• Program is absolutely free (no charge for using). You can use it in any projects including shareware and commercial.
• Easy to use and friendly user interface.
• Minimum changes are needed to be make in project source.
• Export and import of the translation from one project to another.
• Filtering of the strings and properties that will be translated.
• Localization of the any string properties including properties of the TStrings and TCollection descendants.
• Langauges switching at runtime.

3. What do you need to localize your application.

To localize your delphi program You have to make next simple things:

• Create with DelLoc the localization file that will include translations of the resourcestrings and translations of the form's and component's string properties.
• Include unit LcUnit.pas in your project or make it available in search pathes.
• In project source: after loading application call function LoadLcf() where pass as parameters localization file name and locale identificator (LCID) that will be used to translate. You may place the call of LoadLcf() in project source file after "begin" keyword or in the initialization section of the any project unit.
• After creating form which interface and components need to be translated call function TranslateComponent() and pass as parameter the created form. You may place call at the body of the overrided constructor after "inherited" keyword or in the OnCreate event handler. If you inherites all project forms from one base form class you may provide call of the TranslateComponent() only for the base form class.

4. Description and using DelLoc.

If You want to localize string constant from resourcestring block You have to compile project with detailed map file (Choose delphi menu item "Project->Options", tabsheet "Linker" and click item "Map file->Detailed" then rebuild your project). Compiler will make special file with "drc" extension.

To create new localization file in DelLoc choose menu item "File->New". In the opened window choose "exe"-file that need to be localizated and corresponded "drc"-file.

After appearing "Import parameters" window select genue langauge of your application. You also can define masks for filtering strings and component properties that will be localized. Press button "OK". The "Content" window will contents the hierarchy list of the component properties and string constants based on their membership in the sourse files. In dependence of the selected item in "Content" window main grid will show corresponded strings and properties with genue means.

Choose menu item "Languages->Languages" and in the appeared window add to localization file the necessary languages. You can use at any time this window to add or remove localization languages from project.

In the main grid or in the multiline editor enter translation for added languages.

Save and compile localization file by choosing menu item "File->Save and compile". Compiled file is ready to use. If You includes project info in the localization file then you can modify and synchonize it with changes that you made in your project. Also you can use localization file to export translations into another projects.

To modify and synchronize localization file with changes in your project and to import translation from another projects you have to open file with menu item "File-Open". Then choose menu item "Translation->Import translation". Select files with which you want to synchronize localization file or select files to import translation. In window "Import parameters" select languages to synchronize/import and optionally add masks to filter string constants and component properties. Press button OK.

5. Description of the LcUnit.pas.

Unit LcUnit.pas includes declaration of the two functions: LoadLcf() and TranslateComponent(), and declare one type: TLcCallBack.

Function LoadLcf() loads localization file and activates translation for the passed locale identificator.

function LoadLcf( const sFileName : string; iLCID : LCID; pCallBack : TLcCallBack; pUd : pointer ) : integer;

Parameters:

• sFileName - localization file name;
• iLCID - locale identificator to activate. Use Delphi's class TLanguages to inspect all available locale identificators and its string descriptions.
• pCallBack - pointer to callback function of type TLcCallBack. If this parameter is not null then the callback function will be called for each locale identificator supported by the localization file.
• pUd - user defined pointer. Will be passed as parameter to the callback function pCallBack.

Result:

• 1 - localization file was loaded and translation for requested locale was activated;
• 0 - localization file was loaded but translation for requested locale is not present in the localization file. Translation will not be make.
• -1 - localization file error loading. Translation will not be make.

Function TranslateComponent() translate the interface and form's components string propertied.

function TranslateComponent( oComponent : TComponent ) : boolean;

Parameters:

• oComponent - Form which interface and components will be localized.

Result:

• true - localization success;
• false - localization error.

The type TLcCallBack is a prototype of the callback function which pointer is passed into LoadLcf() as parameter. The callback function will be called for each locale identificator supported by the localization file.

type TLcCallBack = function( iLCID : integer; pUd : pointer ) : integer; stdcall;

Parameters:

• iLCID - locale identificator supported in localization file;
• pUd - user defined pointer passed into LoadLcf() as parameter.

Results:

• 0 - stop calling callback for the next locale ids;
• not 0 - continue the callback calls for the next locale ids.

To switch the langauges at runtime You may use next code:
   var
     i : integer;
   begin
     for i := 0 to Screen.FormCount - 1 do TranslateComponent( Screen.Forms[ i ] );
   end;

6. Demo-project.

DelLoc includes demo-project that shows how to:

• collect the locale ids supported by localization file.
• switch the languages at runtime.

7. Parts.

The program package includes:

• DelLoc.* - DelLoc (Delphi localization compiler) program files;
• LcUnit.pas - sourse file to be included in your project.
• Help\*.* - html-desription files;
• Demo\*.* - demo-project;
• readme*.* - readme files.

8. License agreement..

1. DelLoc version 2.51 (SOFTWARE) is freeware. You can freely use this in any projects (including shareware and commercial) without any fee or payment to author.

2. All copyrights to SOFTWARE and all parts of the SOFTWARE are exclusively owned by the author - Serge Gavrilov.

3. SOFTWARE can be freely distributed in non modified form as it's distributed by the author. Nobody can take the payment for distribution of the SOFTWARE without the written sanction of the author.

4. DelLoc IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY KIND IS EXPRESSED OR IMPLIED. YOU USE AT YOUR OWN RISK. THE AUTHOR WILL NOT BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE.

5. Any modification of the SOFTWARE are prohibited.

6. Installing and using SOFTWARE signifies acceptance of these terms and conditions of the license. If you do not agree with the terms of this license agreement you must remove all SOFTWARE files from all your storage devices and cease to use the SOFTWARE.

9. Download.

• dlcinst.exe (~1��). DelLoc inslallator.
• dlcxeinst.exe (~1,4��). DelLocXe installator for Delphi XE.

10. About author.

The author of DelLoc (Delphi localization compiler) - Serge Gavrilov, Russia, Saint-Petersburg.

e-mail: sergegavrilov@mail.ru

icq: 777807