Feature Description
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.
Back to Top of Translations
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.
Users can set any language within the Translation Editor. Simply Double click on the Add Language… text, and the user can begin adding a new Language to the Translation Editor. The current limit of languages is 20. Users will also be able to edit or delete these languages if they are no longer needed within the project.
Multi-Language String
To have a text box be able to use any translations from the Translation Editor, users must set each text box to be a Multilanguage String. Hover over the Text field in the Text Box Basic Properties to accomplish this. Click the Link icon. This will open a window named Binding Properties; click on the Expression tab. Under this,click the Expression field and select Multilanguage String. This will allow the string to be translated to different languages when the translation language changes during runtime. Without it being selected as a Multilanguage String, it will not translate.
Set Translation Language
Users can use the command Set Translation Language within the Command Editor to change the Translation Language. Any object that can have an action can have this command set. Users can set one language for each button.
