How to Localize Help Files

A VPME Multilingual application can have different help files for each language in the application.

Ø To localize Help files

1.   Master Language Help File: If you create a Help file for the Master Language, name it “S<Prefix>Help.hlp”. Store it in your application’s main directory.

2.   String Translations – Help File: Open the String Translations form from your application’s Admin menu. Use the toolbar List control to find the String Translations records with the String ID “Help File”. There should be a String Translations record with the “Help File” String ID for each language in your application.

3.   Enter Language Help Files: Enter the name of the Help file to be used for each language in the language’s “Help File” String Translations record.

Technical Info

When a VPME Multilingual application runs, the S<Prefix>FEnv program executes the SET HELP TO command if the Master Language is used. If using the Master Language, the Shared Data help file or default help file (S<Prefix>Help.hlp) is used.

If the application is being run in a language other than the Master Language, the Multilingual object’s method that translates strings is called and passed the string “Help File”. The name of the help file to be used with the selected language is returned.

To enable this functionality, VPME includes a record in the Strings table that has “Help File” in the CSTRINGID field. You can then create “Help File” records for each language in the String Translations table.

If there is a language specified for a user, the SET HELP TO for that language’s help file is executed after the user has logged-in.

Tip: If a help file has a project-specific name that uses the application prefix, you can enter an expression in the Translated String box and check the Expression check box on the String Translations form. For example, the Translated String box could contain “S”+sgcCurPre+”GBR.HLP” for the British help file.

More:

How to Localize Visual FoxPro Functions and Commands