Table Of Contents

Exporting Strings for Localization

Version:
    Last Modified: August 6, 2018

    Localize applications into additional languages by exporting the strings into a string dictionary file, translating the file, and saving your changes.

    The string dictionary file contains information to localize the following strings:
    • Application title and description
    • Window titles and descriptions
    • Object labels and descriptions
    • Private data (listbox item names, graph plot names, graph cursor names, and graph annotation names)
    • Free labels (panel and diagram)
      spd-note-note
      Note  

      The string dictionary file does not contain information to localize string data in diagram constants, arrays, or clusters.

    To localize most objects in an application, such as object labels and descriptions, complete the following steps. If you need to localize strings that display at run time, such as the strings in dialog boxes and indicators, refer to Creating Custom String Dictionaries for Localization.
    spd-note-note
    Note  

    If you localize an application to a language the editor or run-time engine does not support, some information that displays at run time, such as error messages, remains in the default language.

    1. Open the application you want to localize.
    2. Save the application.
    3. On the Document tab, click Export strings in the Localization section.
    4. Navigate to the string dictionary file using the path in the file dialog box and click OK to close the dialog box.
    5. Create a copy of the string dictionary file and save it in a new folder that indicates the language of the string dictionary file. You must save the new folder within the project folder in the same location as the original dictionary folder and name the new folder using standard Microsoft locale names, such as en-US or zh-CN.

      If you do not follow these guidelines, your application may not be able to locate the localized string dictionary file.

    6. Translate the new string dictionary file and save the changes.
    7. Save and close the project.
    8. Reload the project and reopen the application.
    9. On the Document tab of the panel, select the language from the Preview drop-down menu.

      The localized strings now display in the application.

      spd-note-note
      Note  

      If you modify an application after you export and translate the string dictionary, the string dictionary may contain incorrect or missing keys, and the application may no longer display the correct localized content. If you need to export strings again and want to preserve an existing dictionary, make sure to save a copy of the existing dictionary in a separate location. Export strings overwrites any existing dictionary in the folder for the default language of the editor.

    To localize an application in multiple languages, create copies of the dictionary file and repeat this process to create dictionaries for all desired languages.


    Recently Viewed Topics