Defining the interface language

 

Imagenation is available in several languages. In the Imagenation user interface, you can change the interface and online help language by selecting an item from a drop-down list. Similarly, the Imagenation API has features for defining the interface language.

To find out what languages are available:

· Use the GetAvailableLanguages transaction. It has no parameters.

In the reply, the names of all languages are listed in English.

To find out which language is currently being used:

· Use the GetLanguage transaction. It has no parameters.

This transaction returns both the local and English names of the current language.

To select another language:

· Use the SetLanguage transaction. In this transaction you specify the English name of the language in quotes as the single parameter.

When the interface language is changed through the list in the user interface, Imagenation sends a NotifyIM -- LanguageChanged notification to clients, if it has been registered. Its data syntax provides the English name of the language selected.

The Imagenation user interface is translated using an application called Lingo. The interface files that are produced are called language tables. You can register a language table for use in the API by calling the RegisterLanguageTable transaction.

An include file containing strings with identifiers is also produced by Lingo. After a language table is registered, you can request specific strings in it by using the GetLanguageString transaction.

To unregister a language table, use the UnregisterLanguageTable transaction.

See also