TranslationLookupLoad
The function TranslationLookupLoad creates a lookup map from the Translation Table for the specified source and target languages, and then it loads the map into memory so that it can be used by the function TranslationLookupGet.
Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
---|---|---|---|---|---|---|
TranslationLookupLoad | Translation | Synchronous | Supported | Supported | Not supported | Not supported |
Syntax
TranslationLookupLoad(numSourceLanguageID,numTargetLanguageID)
- numSourceLanguageID
- numTargetLanguageID
- The locale IDs for the source and target langauges, respectively. Both languages must already be configured in the Translation Table.
Returned value
If this function is successfully executed, it returns an ID number (from 0 to 255) for the lookup map. You can then use the ID number to call the functions TranslationLookupGet and TranslationLookupClose.
Value | Description |
---|---|
-1 | Function executed from the Viewer module, or other internal error. |
-2 | Invalid parameter(s). |
-3 | Cannot have more than 256 lookup maps loaded in memory at the same time. |
-4 | The source language is the same as the target language, or the specified languages have not been configured in the Translation Table. |
Notes
When you call this function, you can specify any two languages that have been configured in the Translation Table, even if they were both originally configured as target languages. When the lookup map is created, it automatically cross-references the specified languages. For example, if you configured the Translation Table for your project to include both an English-to-Spanish translation and an English-to-Portuguese translation, you can then specify Spanish and Portuguese when you call this function.
You can have up to 256 lookup maps loaded in memory at the same time, but each map uses system resources and that can affect run-time performance. You should use the function TranslationLookupClose to close a map when you are done with it.
Locale IDs are proprietary language/region codes used in Microsoft Windows. For more information, go to: msdn.microsoft.com/library/ms912047
Examples
TranslationLookupLoad(1033,1046)