Copyright: Copyright © 2001 Borland Software Corporation.                      All rights reserved.                                                 This Help file was compiled on   Wednesday, May 09, 2001 15:59:30.


Translation Tools overview

See also

Borland’s suite of Translation Tools facilitate software localization and simultaneous development of applications for different locales. Because of its integration with the Delphi IDE, the Translation Tools let you manage multiple localized versions of an application as part of a single Delphi project group.

The Translation Tools create and maintain a separate resource DLL for each localized version of the application under development. The Translation Manager (including the external version  called ETM, the External Translation Manager) provides a grid for viewing and editing translated resources. After modifying your translations, you can update all of your project’s resource DLLs with a single menu command. You can also create a central repository to hold translations that you want to reuse in different projects.

The Translation Tools suite is made up of the following tools:

The Translation Manager displays a grid for viewing and editing translated strings and other resources. You can also view the translated form from within the Translation Manager.

The Translation Repository provides a central database for translations that can be shared across projects and by different developers.

The Resource DLL wizard generates and manages resource DLLs for the languages you select.

You can run localized versions of your application in debug mode by setting the active language.

The Resource DLL wizard organizes the localized DLLs associated with an application into a project group. When you use the Translation Tools, you should generally work through the Project Manager, opening the project group first and then selecting the specific forms and units you want to modify. You can also run the Translation Manager externally from the command line.

To configure the tools, choose Tools|Translation Tools Options.

Topics

About the Resource DLL wizard

Creating and updating resource DLLs
Launching the Resource DLL wizard from the File menu
Adding languages to a project
Updating resource DLLs
Removing languages from a project
Restoring languages to a project

Setting the active language

Using the Translation Manager
Editing in the Translation Manager
Using the Multiline editor
Translation Manager toolbars and menus
Keyboard shortcuts
Using the Repository
Using the Auto Translate option

Setting up a translation repository

Files generated by Translation Tools


About the Resource DLL wizard

See also

The Resource DLL wizard presents different menus and options depending on how it is launched. The Resource DLL wizard performs tasks such as the following:

 Creating and update resource DLLs.

 Adding languages to a project.

 Removing languages from a project.

 Setting the active language.

To configure options for the Resource DLL wizard, choose Tools|Translation Tools Options.


Creating and updating resource DLLs

See also

Before you can use the Translation Manager or Repository from within the IDE, you must add languages to your project by running the Resource DLL wizard.

Launching the Resource DLL wizard from the File menu

Adding languages to a project

Updating resource DLLs

Removing languages from a project

Restoring languages to a project


Launching the Resource DLL wizard from the File menu

See also

Launching the Resource DLL wizard from the File menu lets you add languages to your project and remove languages from your project in a single step. It also gives you an opportunity to include extra files, such as .rc files, that the IDE doesn’t know about. If you have multiple projects open in the IDE, you can process several at once.

To use the Resource DLL wizard,

1.	Save and build your project.

2.	With your project open in the IDE, choose File|New|Other, double-click on Resource DLL Wizard, then click Next.

3.	Select your project from the list that appears in the dialog. (That is, make sure a check mark appears in the box to the left of each project you want to process.) At this point, you can also set the root directory for the DLL projects and change the base-language (the language of the resources that are currently in the source) setting for Repository queries. Then click Next.

4.	Select the languages you want to include in your project by checking the boxes next to them. To remove a language, uncheck its box.

Select only languages which are translation targets. You don't need to create a resource DLL for the primary (base) language in which you are developing your application, but you can do so if you want.

You can change the DLL extension for any language by clicking in the Extension column. Some languages have 3-letter extensions where the third letter specifies the minor locale. For example, German (Germany) uses DEU, but if you change the extension to DE, Delphi will load the resource DLLs for any of the German locale settings: German (Germany), DEU; German (Switzerland), DES; or German (Luxembourg), DEL.

Click Next.

5.	Set the directory path for each language’s resource DLL by clicking and typing in the Path column. The directories you specify must fall under the root directory selected in Step 3 above.

Click Next.

6.	To include additional files in your main (application) project, click Add File. When you are done adding files, click Next. (You can also do this from the Files tab in the Translation Manager.)

7.	The languages you’ve selected appear in the next dialog. For each language,

 If a resource DLL already exists for the language (in the directory you have specified), click in the Update Mode column to select Update or Overwrite. Choose Update to keep and modify the existing DLL project; choose Overwrite to create a new, empty DLL project. If you choose Overwrite, the wizard will delete the old DLL project and any translations it contains.

 If no resource DLL exists, “Create New” appears in the Update Mode column. There are no further options to select.

Click Next.

8.	Click Finish to create or update resource DLLs for the languages you’ve selected and include them in your project, and to remove from your project any languages you’ve unselected. (When you remove languages, the wizard removes their resource DLLs from your project, but it does not delete the DLLs or the directories they reside in.)

If the wizard asks to generate a drc file, click Yes. Any project that uses its own resource strings (instead of previously compiled rc files) needs a drc file.

If you are sure that no new drc files are needed (because your project doesn't introduce any resource strings of its own), you can select the "Skip drc files that are not found" check box in the final dialog. This prevents the wizard from generating, or asking to generate, drc files.

Later, you can add languages to and remove languages from your project from the Translation Manager or by rerunning the Resource DLL wizard.

To restore a language after removing it, choose Project|Languages|Add and run the wizard again or run the Translation Manager and choose one of the Add files buttons on the toolbar.

The Resource DLL wizard creates a separate DLL project for each language you have selected. If Automatic Repository Query is enabled (Tools|Translation Tools Options), the wizard populates resource DLLs with translations for any strings that have matches in the Repository. Otherwise, the generated projects contain untranslated copies of the resource strings in your original project. Your next step is to translate these strings in the Translation Manager and build your DLLs.

Because all the generated projects have the same name, they must be kept in separate directories. Do not attempt to edit the generated project (.DPR) files, since your changes will be overwritten the next time the DLL is updated.

References to the generated projects are maintained in the parent project's options (.dof) file. The Resource DLL wizard also creates a project group that includes the parent project and each of the generated DLL projects. It's a good idea to save and use this project group, since it simplifies the task of recompiling the resource DLLs.


Adding languages to a project

See also

You can add languages to a project in several ways:

Use the Resource DLL wizard

Choose Project|Languages|Add

Start the External Translation Manager and use the Environment tab

This topic describes adding files using the Add command. You can add new resource DLLs to a project at any time. If you have multiple projects open in the IDE, you can process several at once.

To add languages to a project:

1.	Save and build your project.

2.	With your project open in the IDE, choose Project|Languages|Add. When you open the Resource DLL wizard this way, it displays only languages that are not yet included in your project.

3.	Select your project from the list that appears in the dialog. (That is, make sure a check mark appears in the box to the left of each project you want to process.) At this point, you can also set the root directory for the DLL projects and change the base-language (the language of the resources that are currently in the source) setting for Repository queries. Then click Next.

4.	Select the languages you want to include in your project by checking the boxes next to them.

Select only languages which are translation targets. You don't need to create a resource DLL for the primary (base) language in which you are developing your application, but you can do so if you wish.

You can change the DLL extension for any language by clicking in the Extension column. Some languages have 3-letter extensions where the third letter specifies the minor locale. For example, German (Germany) uses DEU, but if you change the extension to DE, the program will load the resource DLL for any of the German locale settings: German (Germany), DEU; German (Switzerland), DES; or German (Luxembourg), DEL.

Click Next.

5.	Set the directory path for each language’s resource DLL by clicking and typing in the Path column. The directories you specify must fall under the root directory selected in Step 3 above.

Click Next.

6.	The languages you’ve selected appear in the next dialog. For each language,

If a resource DLL already exists for the language (in the directory you have specified), click in the Update Mode column to select Update or Overwrite. Choose Update to keep and modify the existing DLL project; choose Overwrite to create a new, empty DLL project. Note:If you choose Overwrite, the wizard deletes the existing DLL project and any translations it contains.

If no resource DLL exists, “Create New” appears in the Update Mode column. There are no further options to select.

Click Next.

7.	Click Finish to create or update resource DLLs for the languages you’ve selected and include them in your project.

If the wizard asks to generate a drc file, click Yes. Any project that uses its own resource strings (instead of previously compiled RC files) needs a drc file.

If you are sure that no new drc files are needed (because your project doesn't introduce any resource strings of its own), you can select the "Skip drc files that are not found" check box in the final dialog. This prevents the wizard from generating, or asking to generate, drc files.

Later, you can add languages to and remove languages from your project by rerunning the Resource DLL wizard or by using the Environment tab in the Translation Manager. You can also choose Project|Languages|Add to add languages.

The Resource DLL wizard creates a separate DLL project for each language you have selected. If Automatic Repository Query is enabled (Tools|Translation Tools Options), the wizard populates resource DLLs with translations for any strings that have matches in the Repository. Otherwise, the generated projects contain untranslated copies of the resource strings in your original project. Your next step is to translate these strings in the Translation Manager, and build your DLLs.

Because all the generated projects have the same name, they must be kept in separate directories. Do not attempt to edit the generated project (.dpr) files, since your changes will be overwritten the next time the DLL is updated.

References to the generated projects are maintained in the parent project's options (.dof) file. The Resource DLL wizard also creates a project group that includes the parent project and each of the generated DLL projects. It's a good idea to save and use this project group, since it simplifies the task of recompiling the resource DLLs.


Updating resource DLLs

See also

You can update resource DLLs in several ways. You should first save and build your project, then

From within the IDE, choose Project|Languages|Update Resource DLLs.

From the External Translation Manager, choose Project|Run Updaters (F9).

From the Files tab of the External Translation Manager, choose the Run Updaters (F9) button.

Updating the resource DLLs adds resources to your DLL projects, including new resources that were not in the parent project when the Resource DLL wizard was last run and resources that have been changed. It does not compile the DLLs.

After updating, you need to rebuild each resource DLL project by opening the project in the IDE and choosing Project|Compile. To simplify this process, you can maintain all the resource DLL projects, along with the application itself, in a single project group that can be compiled from the Project Manager by choosing Project|Compile All.


Removing languages from a project

See also

To remove languages from your project,

1.	Save and build your project.

2.	Select Project|Languages|Remove.

3.	Check the languages that you want to remove. Click Next.

4.	Click Finish.

The Resource DLL wizard removes the selected resource DLLs from your project's DOF file, but it does not delete the DLLs or the directories they reside in.

You can also remove languages using the External Translation Manager.

Restoring languages to a project

You can restore a language to your project after it’s been removed.

1.	Choose Project|Languages|Add to start the Resource DLL wizard.

2.	 Specify the directory path of the old resource DLL in the appropriate dialog.

3.	In the Update Mode column, select Update.

For more information, see Adding languages to a project.


Setting the active language

See also

The active language determines which version of your application runs in debug mode when you click the Run button or choose Run|Run. Before changing the active language, make sure you've recompiled the resource DLL for the language you want to use. Then,

1.	Choose Project|Languages|Set Active.

2.	Select a language from the list.

3.	Click Finish.

The base language you are developing in always appears in angle brackets at the top of the language list, like this: <English (United States)>. To set the active language back to the base language, choose Project|Languages|Set Active and select the base language from the top of the list.

Note	Ordinarily, the primary (base) language in which you develop your application matches your computer's Windows system locale. If you have created a resource DLL for this language, your application's initialization code will try to load the DLL even when the active language is set to the base language. In this case, you can run the application without loading a resource DLL by temporarily moving or renaming the base-language DLL. For more information, see Using resource DLLs.


Using the Translation Manager

See also

The Translation Manager provides a grid for viewing and editing translated resources. To open the Translation Manager, choose View|Translation Manager from within the IDE.  Before you can use the Translation Manager in the IDE, you must add languages to your project with the Resource DLL wizard or using Project|Languages|Add.

You can also run the Translation Manager externally from the command line using the following command:

etm60.exe [files]

Where [files] can be project group (*.bpg) files, project (*.dpr) files, or External Translation Manager (*.etm). files.

The external version of the Translation Manager (called the External Translation Manager or ETM) can be used by translators that do not need to run it through the IDE.

The Translation Manager contains three tabs:

 	Environment tab

 	Files tab

 	Workspace tab

The contents of these tabs differs depending on whether you are running the Translation Manager from within the IDE or running ETM externally.

Environment tab

When using the Translation Manager from within the IDE, this tab shows the currently selected languages.

When running the External Translation Manager, you can add languages to your project using this tab much as you do as described in Adding languages to a project. Select the Environment tab and check the languages you want to add to your project.

Files tab

You can use the Files tab to check which files are in the current project and add files to the project. You can also view the original files in your project from the Files tab. You can double-click on any file to display it in the external editor specified on the Preferences page of the Tools|Translation Tools Options. You can also access several commands from the toolbar. See Translation Manager toolbars and menus.

Workspace tab

The Workspace tab contains two panes. The left pane is a tree diagram that displays the list of files in your project, grouped by type. (To display all available languages, make sure that the active project—the one shown in bold in the Project Manager—is your main application project, not one of the resource DLLs.)

The right pane displays a grid for viewing and editing translations.

You can also access several commands from the toolbar. See Translation Manager toolbars and menus. For example, you can view the translated form as you are working on it from within the Translation Manager by selecting a form file and choosing the Show translated form (Ctrl+F8) toolbar button over the grid.

When you select a file in the tree diagram on the left, the Translation Manager displays the associated resources on the right. To switch focus between the left and right panes, press F6.

The Id column shows the name of each resource in its form (.dfm or .xfm) or resource file. Items preceded by O: are objects defined in a form file; items preceded by I: are inherited from another form; items preceded by L: come from a frame.

The first set of columns shows values in your source or base language (the primary language in which you are developing the application). The second set of columns shows corresponding values in the target language selected in the tree diagram. The columns further to the right (for example, “Previous English” or “Previous French”) allow you to track earlier versions of the source strings and their translations.

The Status, Comment, and date columns help you to keep track of your work.

 The date columns—Created and Modified—are maintained automatically.

 Status is automatically changed from Untranslated to Translated the first time you put text in a resource’s translation field; you can also toggle the Status field manually. When a resource has been removed from your project, it still appears in the Translation Manager, but its Status is changed to Unused. (To delete unused items, click the Purge button on the Workspace tab.) If the Status field shows Auto-Translated, it means that the translation was copied automatically from the Repository.

Translation status is also indicated by color codes in the left column of the grid and in the tree diagram. You can configure these color codes by choosing Tools|Translation Tools Options from the main Delphi menu (or pressing the Options button above the tree diagram), then selecting the Colors tab.

You can move and resize these columns with the mouse. To resort the list, click the top of the column for the field you want to sort on.

Note	If your base and target languages use different character sets, you'll need to change the font in the target-language column. To select fonts on a language-by-language basis, choose Tools|Translation Tools Options|Fonts from the main Delphi menu (or choose Tools|Options or use the Options icon from within the Translation Manager), or right-click in the Translation Manager grid and choose the Font menu.

The Translation Manager displays only Localizable properties and their subproperties. See Property and event categories in the Object Inspector for information on these categories.

Properties represented in the Translation Manager can be of various types, including integers, strings, bitmaps, helper classes (like TFont), and enumerated types (like TBiDiMode). Hence, in addition to translating text, you can use the Translation Manager to adjust other properties—such as fonts or the sizes of visual components—in localized versions of your application.

When translating string properties, always enclose the strings in quotation marks. Form (.dfm or .xfm) files use single quotation marks, while Windows .rc files use double quotation marks. If you want the Translation Manager to supply required quotation marks automatically, choose Tools|Translation Tools Options from the main Delphi menu (or press the Options button in the Translation Manager), click the Preferences tab, and select the "Automatically quote strings" check box; this feature, however, does not work for strings that already contain apostrophes, quotation marks, or control characters (such as #13).

The only editable fields in the Translation Manager grid are Status, target language, and Comment. After editing in the target language column, you need to recompile the resource DLL.

Editing in the Translation Manager
Using the Multiline editor

Translation Manager toolbars and menus
Keyboard shortcuts

Using the Repository
Using the Auto Translate option


Editing in the Translation Manager

See also

You can edit in the Translation Manager using the following methods:

Edit directly in the grid. For target-language and Comment fields, click on the value you want to edit and type directly into the field. For Status fields, click on the field, then use the drop-down pick-list.

Use an Edit dialog. Right-click on any row or rows in the grid (but not in an editable field), select Edit, then select the field you want to modify. In the dialog, enter a new value for the field. You can select and edit several rows at once, provided the rows contain data of the same type.

For translations with more than one line, use the Multiline editor, described below.

Remember to rebuild your DLLs after editing.

Using the Multiline editor

The Multiline editor allows you to edit translations that are lengthy or contain multiple lines of text separated by hard returns. To start the editor, place the cursor on any row in the grid, then click the Multiline Editor button (on the right above the grid). The editor displays the source and target languages in separate panes. Only the target language is editable.

A row of buttons at the top of the editor provide navigation and other functions.

Use the Up and Down arrows to move to the previous or next string in the Translation Manager grid.

Use the Tile Across and Tile Down buttons to change the orientation of the editor panes.

Click Save to save your changes.

Click Close to discard unsaved changes and close the editor.

Use the Font button to change the display font in the editor. The changes apply to whichever pane the cursor is in when you click the Font button and affect the Translation Manager grid as well as the Multiline editor.

Click Word Wrap to enable or disable wrapping of long lines.


Translation Manager toolbars and menus

See also

ETM menu commands

The following commands are on the main menu of the External Translation Manager.

File commands (used from the Files tab)

New 	Starts new translation project (Shift+Ctrl+N).

Open 	Displays the Open dialog box where you can choose files to open (Shift+Ctrl+O).

Reopen	Opens a project or file that you recently opened.

Save	Saves the current project (Shift+Ctrl+S).

Save As	Allows you to save the current project under a new name.

Exit	Closes the External Translation Manager.

Project commands

Add File	Displays the Open dialog where you can select files to add (Shift+Ctrl+A).

Add from directory	Displays the Browse dialog where you can add multiple files to a project by browsing to a directory and clicking OK (Shift+Ctrl+D).

Remove File	Removes selected files from the current project (Shift+Ctrl+R).

Run Updaters 	Updates the translated files with updates specified. If you update the translations, this updates the dfn/xfn and form file (F9).

Tools command

Options	Displays the Translation Tools dialog box where you can configure the Translation Tools.

Help commands

Contents	Displays the ETM.hlp file.

About	Displays version information about the External Translation Manager.

Toolbars

The following buttons are available on all tabs of the Translation Manager:

Toolbar button	Description

Options 	Equivalent to Tools|Translation Tools Options. It displays the Translation Tools dialog box where you can configure the Translation Tools.

Translation Repository	Equivalent to Tools|Translation Repository. It displays the Translation Repository.

Exit 	Closes the Translation Manager.

The following buttons are available on the External Translation Manager:

Toolbar button	Description

New 	Starts new translation project (Shift+Ctrl+N).

Open 	Displays the Open dialog box where you can choose files to open (Shift+Ctrl+O).

Save	Saves the current project (Shift+Ctrl+S).

Save As	Allows you to save the current project under a new name.

The following buttons are available on the Files tab of the External Translation Manager:

Toolbar button	Description

Add files to project	Displays the Open dialog where you can select files to add.

Add from directory	Displays the Browse dialog where you can add multiple files to a project.

Remove files from project	Select files to remove and chose this button.

Run the updaters (F9)	Updates the translated files with updates specified. If you update the translations, this updates the dfn/xfn and form file.

Create Delphi project	Creates a new Delphi project from the Translation Manager for the resources only. The project can be opened in Delphi.

Create C++Builder project	Creates a new C++Builder project from the Translation Manager for the resources only. The resource project can be opened in C++Builder.

The following toolbar buttons are available on the left of the Workspace tab of the Translation Manager:

Toolbar button	Description

Refresh 	Shows the current tree view including any recent changes (Shift+Ctrl+F5).

Expand one level	Expands the selected level in the tree view.

Expand all levels	Expands all levels in the tree view.

Collapse	Collapses all levels in the tree view.

Purge	Synchronizes the translated version with the base language version, for example, when changes are made to the base version (Shift+Ctrl+F7).

The following buttons are available in the Workspace tab (right pane) when a form is selected in the tree diagram on the left.

Save	Saves the changes you have made to your resource DLL project.

Cut	Deletes selected text and copies it to the clipboard.

Copy	Copies selected text to the clipboard.

Paste	Copies text from the clipboard to the current cursor position.

Find	Searches for specified text in the Translation Manager grid.

Find in Files	Searches for specified text across multiple files.

Reset columns	Adjusts column width in the grid.

Multiline Editor	Opens the Multiline editor.

Actions 	Displays a menu that contains editing and other functions, including filtering the list, hiding columns, changing fonts, copying, changing status, adding strings to the repository, getting functions, finding untranslated items, and selecting all. You can also access this menu by right-clicking on the grid.

Show original form 	Shows the form before changes were made (Ctrl+F7).

Show translated form	Shows the translated form (Ctrl+F8).

Refresh translated form 	Updates the form with any changes (Ctrl+F5).

Keep forms on top 	Causes the forms to stay on top of other windows (Ctrl+K).

Keyboard shortcuts

Keyboard shortcuts available in the Workspace tab of the Translation Manager include

Ctrl+N	Find next untranslated item.

Ctrl+O	Copy text from source (base language) column into translation column.

Ctrl+T	Change status to Translated.

Ctrl+P	Restore translation from Previous translation column.

Ctrl+D	Copy translation from prior row in grid.

Ctrl+A	Select everything in grid.

Ctrl+K	Keep forms on top.

Ctrl+F5	Refresh translated form.

Ctrl+F7	Show original form.

Ctrl+F8	Show translated form.


Using the Repository

See also

You can access the Translation Repository from the Translation Manager grid by right-clicking on any resource and choosing Repository. From the Repository menu, choose Add Strings to Repository or Get Strings from Repository.

Add Strings to Repository stores the translation from the selected row(s) into the Repository database.

Get Strings from Repository searches the Repository for a translation in the target language whose source string matches the selected resource.

If you choose Get Strings from Repository and the Repository contains exactly one translation that matches the selected source string, it copies that translation into the target-language column. If the Repository contains more than one match for the selected resource, its default behavior is to retrieve the first matching translation it finds; you can change this behavior by choosing Tools|Translation Tools Options from the main Delphi menu (or pressing the Options button in the Translation Manager), clicking the Preferences tab, then selecting an option under Multiple Find Action:

 Select Skip if you want the Translation Manager to retrieve nothing from the repository when it finds more than one match.

 Select Use first (the default) if you want the Translation Manager to retrieve the first matching translation in the Repository.

 Select Display selection if you want the Translation Manager to offer you a choice when it finds multiple matching translations.

Remember to rebuild your DLLs after editing.

Using the Auto Translate option

To enable the Auto Translate option, choose Tools|Translation Tools Options from the main Delphi menu (or press the Options button in the Translation Manager), select the Preferences tab, then check Automatic Repository Query. Each time your DLLs are updated, Auto Translate searches the Repository for translations whose source values match the ones in the Translation Manager grid.

If Auto Translate finds exactly one match for a string, it retrieves that translation and copies it to the DLL project. If it finds more than one match, its default behavior is to retrieve the first matching translation in the Repository. You can change this behavior by choosing Tools|Translation Tools Options from the main Delphi menu (or pressing the Options button in the Translation Manager), clicking the Preferences tab, then selecting an option under Multiple Find Action:

 If you select Skip, Auto Translate skips strings for which it finds more than one match.

 If you select Use first (the default), Auto Translate retrieves the first matching translation in the Repository.

 If you select Display selection, Auto Translate displays a selection dialog when it finds more than one match.

When a translation has been copied automatically from the Repository, it is marked as Auto-Translated in the Translation Manager's Status column.


Setting up a translation repository

See also

While working in the Translation Manager, you can use the Repository to store and retrieve translated strings. You can also access the Repository directly, through its own interface, to import and export data, find and edit strings, or delete unwanted translations.

To open the Repository, choose Tools|Translation Repository or click the Translation Repository icon in the upper left corner of Translation Manager.

The Repository stores data, in binary format, in a file with the .rps extension. By default, it uses Default.rps in the BIN directory.

 To save changes to the current rps file, click the Save button.

 To save the current data in a different file, click the Save As button.

 To open a different rps file, click the Open button.

 To open a new, empty rps file, click the New button.

 To search for a string in the current repository column, click the Find button.

 To delete a record, select any row and press the Delete key.

 To edit an item, click in the string you want to edit to position the cursor. You can also enable editing by selecting an item and pressing F2.

Several Repository settings are controlled from the Translation Tools Options dialog. To change these settings, choose Tools|Translation Tools Options from the main Delphi menu (or press the Options button in the Translation Manager), then select the Preferences tab.

 To select a different .rps file, enter a file name under Repository.

 To make the Resource DLL wizard automatically retrieve strings from the Repository, select Automatic Repository Query.

 To determine how the Repository responds when it finds more than one translation for the same source string, select an option under Multiple Find Action.

Importing and exporting data

The Repository's Import and Export functions allow you to exchange data between rps files. This is useful for sharing translations in workgroups and development teams. Importing and exporting are accomplished through intermediate text files in XML format.

 To Export the contents of the current repository to an xml file, click the Export button. When the file-selection dialog opens, specify a file name and click Save.

 To export selected items—rather than the whole repository—drag the mouse over the rows you want to export. Make sure to select both columns of each row. Then click the Export button.

 To import the contents of an XML file into the current repository, click the Import button. When the file-selection dialog opens, choose a file and click Open.

Note	The Import and Export functions require MSXML.DLL. If you don't have this file on your system, you can get it by installing Microsoft Internet Explorer 5.


Files generated by Translation Tools

See also

Files generated by the Translation Tools include

.dfn/xfn files	The Translation Tools maintain a separate dfn/xfn file for each form in your application and each target language. These files contain the data (including translated strings) that you see in the Translation Manager.

.rc files	The Resource DLL wizard, using the compiler-generated .drc file, creates an .rc file for each target language. These .rc files contain special comments that are used by the Translation Tools.

.rps files	The Translation Repository stores data in an .rps file. You can maintain more than one repository by saving multiple .rps files.

Warning:	You should not edit any of these files manually.


Find dialog

See also

Use the Find dialog to search for text in the Translation Manager.

 Enter the text you want to search for after Text to Find.

 Click the Font button (to the right of Text to Find) to change fonts.

 Under Options, you can enable case-sensitivity and whole-word search. Select Ignore Pick Letters to disregard the ampersands (&) that indicate accelerator keys in button and menu-item captions.

 Under columns, select the columns you want to search. (To select or unselect all columns, right-click and choose Check All or Uncheck All.)

 Under Scope, select Global to search all rows or Selected Rows to search only the rows highlighted in the translation manager.

When your search results are displayed, editable fields (Status, target language, and Comment) are distinguished from noneditable fields by colored icons on the left.


Find in Files dialog

See also

Use the Find in Files dialog to search multiple files in the Translation Manager.

 Enter the text you want to search for after Text to Find.

 Click the Font button (to the right of Text to Find) to select a font.

 Under Options, you can enable case-sensitivity and whole-word search. Select Ignore Pick Letters to disregard the ampersands (&) that indicate accelerator keys in button and menu-item captions.

 Select Search Files in Project to search only the currently open project. Select Search in All Projects to search all projects in the current project group.

 Under File Types, select Forms, Resource Scripts, or both. Then choose the columns you want to search from the list on the right. (To select or unselect all columns, right-click and choose Check All or Uncheck All.)

 You can select different search columns for each file type. Highlight Forms or Resource Scripts, then select search columns.

 To use the same search columns for Forms and Resource Scripts, select Keep Check Lists Synchronized.

When your search results are displayed, editable fields (Status, target language, and Comment) are distinguished from noneditable fields by colored icons on the left.


Select a Font (Translation Manager Find-in-Files dialog)

See also

Use this dialog to specify a font for the text you enter in the Text to Find field. The dialog displays all of the fonts used in your project.

To configure fonts for use with the Translation Tools, choose Tools|Translation Tools Options (or press the Options button in the Translation Manager), then select the Fonts tab.


Translation Tools Options dialog box (Tools|Options)
Translation Tools Options dialog box

See also

Use the Translation Tools Options dialog box to configure the Translation Tools. The Translation Tools Options dialog box has five tabs:

Preferences

Colors

Fonts

Packages

Form Designer


Preferences (Tools|Options)

See also

Use the Preferences tab of the Translation Tools Options dialog box to configure the Translation Tools.

Translation Repository

Sets the location of the Translation Repository, a database for translations that can be shared by different projects.

Filename	Enter the full name and directory path of the .rps file where the Translation Repository is stored.

Updaters

Automatic repository query	Automatically populates resource DLLs with translations for any strings that have matches in the Repository.

External Translation Manager

Automatically quote strings	Supplies required quotation marks around translated strings. This feature does not work for strings that already contain apostrophes, quotation marks, or control characters (such as #13).

Miscellaneous

Automatically save files	Saves the current project, without asking first, whenever appropriate (for example, before closing the Translation Manager or running the Resource DLL wizard).

External Editor

Enter the name of the external editor you plan to use when using an external editor, for example, notepad.exe. You can double-click on files on the files tab of the External Translation Manager to display files in the external editor.

Multiple find action

Determines how the Repository responds when it finds more than one translation for the same source string.

Skip	Doesn't retrieve anything if the Repository contains more than one match.

Use first	Retrieves the first match.

Display selection	Offers the user a choice.


Colors (Tools|Options)
Color (Tools|Options)

See also

Use the Colors tab of the Translation Tools Options dialog to define a color scheme for the Translation Manager. You can specify colors to distinguish translated and untranslated resources, editable and noneditable fields, selected (highlighted) and unselected items, and so forth.

The Color Scheme list box lets you choose from a selection of predefined color schemes. To add your own color definitions to the list, click the Save As button and specify a name. To remove a user-defined color scheme from the list, select the scheme from the list box and click the Remove button.

To turn off color-coding in the Translation Manager, uncheck the Use Colors check box.


Fonts (Tools|Options)

See also

In the Translation Tools Options dialog box, click the Fonts tab to change the font for each language in the Translation Manager.

Grid fonts	Select one or more available languages.

Font	Click the Font button to select fonts, font styles, font sizes, effects, color, and script for the languages you’ve selected. Click OK to save changes.


Packages (Tools|Options)

See also

In the Translation Tools Options dialog box, click the Packages tab to add packages to or remove packages from the resource project.

To add packages, click Add and navigate to the packages you want to add. You can add one or more packages at a time.

To remove packages, select one or more packages to be deleted and choose Remove.


Form Designer (Tools|Options)

See also

In the Translation Tools Options dialog box, click the Form Designer tab to change the grids in the Form Designer that is displayed from the icon on the Workspace tab. You can set the following options:

Option	Description

Display grid	Check this box to display dots on the form making the grid visible.

Snap to grid	Check this box to automatically align components with the grid as you are moving, resizing, or drawing on the form. You cannot place a component between gridlines.

Grid size X	Sets grid spacing in pixels along the x-axis. Specify a higher number (between 2 and 128) to increase grid spacing.

Grid size Y	Sets grid spacing in pixels along the y-axis. Specify a higher number (between 2 and 128) to increase grid spacing.


Link not found

The topic you requested is either not available or not linked to this Help system. This can occur if you launched this Help file from a system on which Delphi has not yet been installed, or if the subject matter you are requesting is not available in your edition of Delphi.


The topic you requested is now loading. If it does not appear within a few seconds, the topic is either not available or not linked to this Help system. This can occur if you launched this Help file from a system on which Delphi has not yet been installed, or if the subject matter you are requesting is not available in your edition of Delphi.