Translation of Controls in the Dialog Editor

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

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

To enable localisable dialogs

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

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

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

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

  3. Click Add in the dialogue box to add a language entry.

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

  4. The first time that you click Add, you will see the Set Default User Interface Language dialogue box. Subsequently, this dialogue box has the name Add User Interface Language.

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

  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 localisable controls in your dialog

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

  1. Switch the Current Language list box 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 list box.

  4. Using the control's property dialogue boxes, 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 LibreOffice, 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 LibreOffice that does not know localisable string resources for Basic dialogs, the user will see the default language strings.