Translation of Controls in the Dialog Editor

The Language toolbar in the Basic IDE dialog editor shows controls to enable and manage localizable dialogs.

By default, any dialog that you create only contains string resources for one language. You may want to create dialogs that automatically show localized strings according to the user's language settings.

To enable localizable dialogs

1. In the Basic IDE dialog editor, open the Language toolbar choosing View - Toolbars - Language.

   If the current library already contains a localizable dialog, the Language toolbar is shown automatically.

2. Click the Manage Languages icon on the Language toolbar or on the Toolbox bar.

   You see the Manage User Interface Language dialog. The dialog manages languages for the current library. The name of the current library is shown on the title bar.

3. Click Add in the dialog to add a language entry.

   This step enables all new dialogs to contain localizable string resources.

4. The first time you click Add, you see the Set Default User Interface Language dialog. The following times you click Add, this dialog has the name Add User Interface Language.

   You can also change the default language in the Manage User Interface Language dialog.

5. Select a language.

   This adds string resources to contain the translated versions of all strings to the dialog properties. The set of dialog strings of the default language is copied to the new set of strings. Later, you can switch to the new language and then translate the strings.

6. Close the dialog or add additional languages.

To edit localizable controls in your dialog

Once you have added the resources for localizable strings in your dialogs, you can select the current language from the Current Language listbox on the Language toolbar.

1. Switch the Current Language listbox to display the default language.

2. Insert any number of controls to your dialog and enter all strings you want.

3. Select another language in the Current Language listbox.

4. Using the control's property dialogs, edit all strings to the other language.

5. Repeat for all languages that you added.

The user of your dialog will see the strings of the user interface language of the user's version of Collabora Office, if you did provide strings in that language.

If no language matches the user's version, the user will see the default language strings.

If the user has an older version of Collabora Office that does not know localizable string resources for Basic dialogs, the user will see the default language strings.