Feature Description
The Translation Editor is used to support multiple languages within one project. Users can specify which languages they want to have supported in their project. Within it, they can set up translations for specific words for all languages, and be able to set up within the project which languages to display via the Command Editor.
| Table of Contents | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Designer Functionalities
Translation Editor
To open up the Translation Editor, go to Tools > Translation Editor or select Open Translation Editor… on the Toolbar. In the Translation Editor, English will appear by default. Users can add new Keys, and as many languages as needed for the project. Users will be able to delete any unused keys, copy and paste them, or cut and paste them, and will be able to add any Keys that are missing within the Translation Editor.
Keys
Keys are used as the master for the translation. Once a key is set, then the user can set translations for what languages it needs to be translated to. Keys must be established for the Translation Editor to be able to translate any words set within it.
Languages
Unlike its predecessor, Xpanel Designer, Canvas does not include a dedicated Multi-Langauge String object. Instead, users can utilize the Translation Editor window to configure the key used for translations. To access this window, click Tools > Translation Editor.
The Key column is used to input a string that will be used as the master for all multi-language objects. Once the key phrase has been established, the user can add languages at will by double-clicking the Click to create language field and entering the name of a new language. In the below example, three languages have been created: English, French, and German. For these three languages, translations have been manually entered for the two available key phrases.
With the key phrases and translations entered in the Translation Editor, the user can now begin designating text objects as Multi-language Strings. To accomplish this, the user must find the Text property in the Property Editor window and click the tag-binding icon for this property. Once the Binding Properties window opens, navigate to the Expression tab and click to open the drop-down menu. Select Multilanguage String, then click OK. Note that the text in the Initial Value field must exactly match one of the previously defined key phrases to be translated.
Now that the text object has been designated as a Multi-language String, the last step is to create buttons that can be used to swap between the available languages easily. To accomplish this, the user must create an Action Command. In the Action Command Editor window, select Set Translation Language from the Action drop-down menu. Then, select the desired language in the Language drop-down menu and click OK.
Once the Action Command has been created, the user can link this action to an object of their choosing. In the below example, the Set Translation Language action is bound to the flag icons.