Add the BoTran2Global Template to your app and fill in the prompts.  BoTran2Global automatically populates the BoTran2Ext template on all procedures in the app.

 

Global1

 

Disable BoTran in this app if you have compile problems and you Mistakenly suspect BoTran2 as the source of your problems.<g>  This will disprove any more notions about that.

 

If this is part of a multi-dll app, check the appropriate boxes.  You should only export Global data in your root dll.

 

BoTran2 uses a Global Queue for Translation by default, but if you need a smaller memory footprint, Unchecking this box will use direct file access which is blazing fast when stored in the local current directory with the app.  BoTran2 is not recommended for use with direct file access across a network.

 

Select a Translation File (*.BTL) to use with the app.  Select the same file that you used in  the JumpStart Utility Template for this app.  This file name defaults to "%Application.btl".  This prompt is only available on the app with EXE extension. It is highly recommended this file reside in a local directory along with the app. 

 

Select an Ini File for Parameter.  This ini file should reside in the local directory along with the exe and BTL file.  It is used by the global template to initialize the language selection, and by the BoTran2Lang control template to dynamically change languages, and store the newly selected language.  You can also alternate your current Language (BTL) file in use if you support more than 28 Languages.  Then check the box "I will control BTL File and Lang used" if you want to take over control of the Language files, and use your own ini file or TPS control file.  You can also substitute your own procedure or other methods of changing Languages and Language files.  The default Language control uses one Language file and supports 27 alternate Languages.  If you are using this as a network app, and store the exe and dll's locally along with the BTL files and ini, you can have the apps running in different languages simultaneously.

 

Errors and updating.  It is recommended that you leave 'Do not Display BoTran File Errors' and 'Do not Update the BoTran File' checked.  'Do not Update the BoTran File' when unchecked is for using to pick up strings that JumpStart may have missed.    If you leave this unchecked and run in a language other than default, it can cause translated strings to be added to your BTL file.  This should only be used when developing an app, running it in a test, with a blank extra language picked, so it will add any untranslated strings to the language file.  Touch each procedure to cover the possibilities.   Jumpstart should be run any time you make text changes in the app, as it only adds new text, and will do no harm. 

 

Force Early Translation,3rdParty Support was added due to the fact that many 3rdParty vendors are adding menubars, taskbar's, task panels, and doing other cool things in the the wrong embeds before the window is really open and translated.  This checkbox will cure many of those problems by forcing the SV translator to translate the window as early as possible.  There is a global switch if you have a lot of problems, and local procedure switches if you only have one or a few problems with this.

 

 

Global3 Global4

 

There are 7 hooks provided by BoTran2 to intercept and translate Captions and Texts being sent to the various dialogs and messages.  It merely intercepts them, and then sends them back to whatever procedure or default you are using.  The hooks are provided "very late in the game" so they can play well with other 3rdParty providers such as MessageBox by Capesoft(tm).    Just turn off the ENV stuff in MessageBox and let BoTran2 handle that<g>.

 

ABC Template Chain.

Check the box if you are using BoTran2 Class for the Translator.  Check the box if you want BoTran2 to Translate the Global Errors.  These checkboxes automatically substitute the BoTran2 Classes for the Defaults as needed.  This is only available for the ABC Chain.

 

 

Translate Print Preview will use a modified Translated version of the Default Print Previewer supplied by the templates instead of the default one.  It uses one that is part of the BoTran2 Class.  It is only available in the Clarion Legacy Chain.

 

  Global5

 

BoTran2 Locale replaces the messy ENV files, etc used by the System.

They basically translate the system variables use by the app and are pretty much self-explanatory.

See Under the Hood Locale ENV Support for more info.

Sometimes you can use the Checkbox Only use LOCALE(WINDOWS) to use the endusers Window ENV to work properly.

 

Global6

 

Make sure you Enable Run-Time Translation in the Global templates.