Contents

# Translation of Controls in the Dialog Editor

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

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

## To enable localisable dialogues

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

   If the current library already contains a localisable dialogue, 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 dialogue. The dialogue manages languages for the current library. The name of the current library is shown on the title bar.

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

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

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

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

5. Select a language.

   This adds string resources to contain the translated versions of all strings to the dialogue properties. The set of dialogue 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 dialogue or add additional languages.

## To edit localisable controls in your dialogue

Once you have added the resources for localisable strings in your dialogues, 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 dialogue and enter all strings you want.

3. Select another language in the Current Language listbox.

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

5. Repeat for all languages that you added.

The user of your dialogue 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 dialogues, the user will see the default language strings.

Related Topics

Creating a Basic Dialogue

Creating Controls in the Dialog Editor

Opening a Dialog With Basic

Programming Examples for Controls in the Dialog Editor