1<?xml version="1.0" encoding="UTF-8"?>
2
3<!--***********************************************************
4 *
5 * Licensed to the Apache Software Foundation (ASF) under one
6 * or more contributor license agreements.  See the NOTICE file
7 * distributed with this work for additional information
8 * regarding copyright ownership.  The ASF licenses this file
9 * to you under the Apache License, Version 2.0 (the
10 * "License"); you may not use this file except in compliance
11 * with the License.  You may obtain a copy of the License at
12 *
13 *   http://www.apache.org/licenses/LICENSE-2.0
14 *
15 * Unless required by applicable law or agreed to in writing,
16 * software distributed under the License is distributed on an
17 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
18 * KIND, either express or implied.  See the License for the
19 * specific language governing permissions and limitations
20 * under the License.
21 *
22 ***********************************************************-->
23
24<helpdocument version="1.0">
25<meta>
26<topic id="textsbasicguidetranslationxml" indexer="include" status="PUBLISH">
27<title id="tit" xml-lang="en-US">Translation of Controls in the Dialog Editor</title>
28<filename>/text/sbasic/guide/translation.xhp</filename>
29</topic>
30</meta>
31<body>
32<bookmark xml-lang="en-US" branch="index" id="bm_id8915372">
33<bookmark_value>dialogs;translating</bookmark_value>
34<bookmark_value>localizing dialogs</bookmark_value>
35<bookmark_value>translating dialogs</bookmark_value>
36</bookmark>
37<paragraph role="heading" id="hd_id3574896" xml-lang="en-US" level="1" l10n="NEW"><variable id="translation"><link href="text/sbasic/guide/translation.xhp">Translation of Controls in the Dialog Editor</link>
38</variable></paragraph>
39<paragraph role="paragraph" id="par_id4601940" xml-lang="en-US" l10n="NEW"><ahelp hid=".">The Language toolbar in the Basic IDE dialog editor shows controls to enable and manage localizable dialogs.</ahelp></paragraph>
40<paragraph role="paragraph" id="par_id9538560" xml-lang="en-US" l10n="NEW">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.</paragraph><comment>current language listbox</comment>
41<bookmark xml-lang="en-US" branch="hid/.uno:CurrentLanguage" id="bm_id9421979" localize="false"/>
42<paragraph role="paragraph" id="par_id6998809" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Select the language for the strings that you want to edit. Click the Manage Languages icon to add languages.</ahelp></paragraph><comment>Manage Language icon is in sbasic/shared/02/20000000.xhp</comment><comment>present languages box in manage user interface language dialog</comment>
43<bookmark xml-lang="en-US" branch="hid/basctl:ListBox:RID_DLG_MANAGE_LANGUAGE:LB_LANGUAGE" id="bm_id1646778" localize="false"/>
44<paragraph role="paragraph" id="par_id71413" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Click a language, then click Default to set the language as default, or click Delete to remove the language from the list.</ahelp></paragraph><comment>add</comment>
45<bookmark xml-lang="en-US" branch="hid/basctl:PushButton:RID_DLG_MANAGE_LANGUAGE:PB_ADD_LANG" id="bm_id1228370" localize="false"/>
46<paragraph role="paragraph" id="par_id2924283" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Opens a dialog where you can add a language to the list.</ahelp></paragraph><comment>delete</comment>
47<bookmark xml-lang="en-US" branch="hid/basctl:PushButton:RID_DLG_MANAGE_LANGUAGE:PB_DEL_LANG" id="bm_id1601611" localize="false"/>
48<paragraph role="paragraph" id="par_id5781731" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Select a language in the list and click Delete to remove that language. When you remove all languages, the string resources for localizable dialogs are removed from all dialogs in the current library.</ahelp></paragraph><comment>default</comment>
49<bookmark xml-lang="en-US" branch="hid/BASCTL_PUSHBUTTON_RID_DLG_MANAGE_LANGUAGE_PB_MAKE_DEFAULT" id="bm_id733359" localize="false"/>
50<paragraph role="paragraph" id="par_id6942045" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Select a language in the list and click Default to set the language as default language.</ahelp></paragraph><comment>set default user interface dialog</comment>
51<bookmark xml-lang="en-US" branch="hid/basctl:ListBox:RID_DLG_SETDEF_LANGUAGE:LB_DEF_LANGUAGE" id="bm_id879848" localize="false"/>
52<paragraph role="paragraph" id="par_id4721823" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">The default language will be used as a source for all other language strings.</ahelp></paragraph><comment>available languages box</comment>
53<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_ADDNEW_CONTROL" id="bm_id8675191" localize="false"/>
54<paragraph role="paragraph" id="par_id5806756" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Add UI languages for your dialog strings.</ahelp></paragraph>
55<paragraph role="heading" id="hd_id6596881" xml-lang="en-US" level="2" l10n="NEW">To enable localizable dialogs</paragraph>
56<list type="ordered">
57<listitem>
58<paragraph role="paragraph" id="par_id8750572" xml-lang="en-US" l10n="NEW">In the Basic IDE dialog editor, open the Language toolbar choosing <item type="menuitem">View - Toolbars - Language</item>.</paragraph>
59<paragraph role="paragraph" id="par_id2224494" xml-lang="en-US" l10n="NEW">If the current library already contains a localizable dialog, the Language toolbar is shown automatically.</paragraph>
60</listitem>
61<listitem>
62<paragraph role="paragraph" id="par_id7359233" xml-lang="en-US" l10n="NEW">Click the <emph>Manage Language</emph> icon
63<image id="img_id2526017" src="res/commandimagelist/sc_managelanguage.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id2526017" xml-lang="en-US">Manage Language icon</alt>
64</image> on the Language toolbar or on the Toolbox bar.</paragraph>
65<paragraph role="paragraph" id="par_id6549272" xml-lang="en-US" l10n="NEW">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.</paragraph>
66</listitem>
67<listitem>
68<paragraph role="paragraph" id="par_id6529740" xml-lang="en-US" l10n="NEW">Click Add in the dialog to add a language entry.</paragraph>
69<paragraph role="paragraph" id="par_id7811822" xml-lang="en-US" l10n="NEW">This step enables all new dialogs to contain localizable string resources.</paragraph>
70</listitem>
71<listitem>
72<paragraph role="paragraph" id="par_id9121982" xml-lang="en-US" l10n="NEW">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.</paragraph>
73<paragraph role="paragraph" id="par_id3640247" xml-lang="en-US" l10n="NEW">You can also change the default language in the Manage User Interface Language dialog.</paragraph>
74</listitem>
75<listitem>
76<paragraph role="paragraph" id="par_id3808404" xml-lang="en-US" l10n="NEW">Select a language.</paragraph>
77<paragraph role="paragraph" id="par_id4585100" xml-lang="en-US" l10n="NEW">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.</paragraph>
78</listitem>
79<listitem>
80<paragraph role="paragraph" id="par_id2394482" xml-lang="en-US" l10n="NEW">Close the dialog or add additional languages.</paragraph>
81</listitem>
82</list>
83<paragraph role="heading" id="hd_id631733" xml-lang="en-US" level="2" l10n="NEW">To edit localizable controls in your dialog</paragraph>
84<paragraph role="paragraph" id="par_id2334665" xml-lang="en-US" l10n="NEW">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.</paragraph>
85<list type="ordered">
86<listitem>
87<paragraph role="paragraph" id="par_id8956572" xml-lang="en-US" l10n="NEW">Switch the Current Language listbox to display the default language.</paragraph>
88</listitem>
89<listitem>
90<paragraph role="paragraph" id="par_id500808" xml-lang="en-US" l10n="NEW">Insert any number of controls to your dialog and enter all strings you want.</paragraph>
91</listitem>
92<listitem>
93<paragraph role="paragraph" id="par_id8366649" xml-lang="en-US" l10n="NEW">Select another language in the Current Language listbox.</paragraph>
94</listitem>
95<listitem>
96<paragraph role="paragraph" id="par_id476393" xml-lang="en-US" l10n="NEW">Using the control's property dialogs, edit all strings to the other language.</paragraph>
97</listitem>
98<listitem>
99<paragraph role="paragraph" id="par_id2655720" xml-lang="en-US" l10n="NEW">Repeat for all languages that you added.</paragraph>
100</listitem>
101</list>
102<paragraph role="paragraph" id="par_id3682058" xml-lang="en-US" l10n="NEW">The user of your dialog will see the strings of the user interface language of the user's version of %PRODUCTNAME, if you did provide strings in that language.</paragraph>
103<paragraph role="paragraph" id="par_id5977965" xml-lang="en-US" l10n="NEW">If no language matches the user's version, the user will see the default language strings.</paragraph>
104<paragraph role="paragraph" id="par_id3050325" xml-lang="en-US" l10n="NEW">If the user has an older version of %PRODUCTNAME that does not know localizable string resources for Basic dialogs, the user will see the default language strings.</paragraph>
105<section id="relatedtopics">
106<embed href="text/sbasic/guide/create_dialog.xhp#create_dialog"/>
107<embed href="text/sbasic/guide/insert_control.xhp#insert_control"/>
108<embed href="text/sbasic/guide/show_dialog.xhp#show_dialog"/>
109<embed href="text/sbasic/guide/sample_code.xhp#sample_code"/>
110</section>
111</body>
112</helpdocument>
113