Adding Languages to a Project
Go Up to Translation Manager in the IDE
You can add languages to your project using the Resource DLL Wizard. For each language that you add, the wizard generates the project for the localized resource DLL. The wizard generates this localized resource DLL project in your project group. Each resource DLL project is created in a separate subdirectory with the name based on the language locale.
Contents
To add a language to a project
- Build your project.
- With your project opened in the IDE, choose File > New > Other > Delphi Projects (or C++Builder Projects) > Resource DLL Wizard to open the Resource DLL Wizard. Otherwise, choose Project > Languages > Add to open the Add Languages dialog box, which provides the same functionality as the Resource DLL Wizard.
- Make sure your project is selected in the list that appears in the wizard and then click Next.
- Select the check boxes next to the languages that you want to add to your project and then click Next.
- Review the directory paths that the wizard will use for the resource DLL projects for the languages to add.
- Tip: To change the path, click the path, and then click the ellipsis (...) button to browse to a different directory.
- When you are satisfied with the path information, click Next.
- Indicate the Update mode for the resource DLL project to be created:
- If no resource DLL project for the selected language exists yet,
Create New
appears in the Update Mode column. Click Next. - If a resource DLL project for the selected language exists 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 resource DLL project. Choose Overwrite to create a new, empty resource DLL project and to delete the old project and any translations it contains. Click Next.
- If no resource DLL project for the selected language exists yet,
- Review the summary of what the wizard will do and click Finish to create or update the resource DLL projects for the languages you have selected. 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 files are needed (because your project does not introduce any resource strings of its own), select Skip DRC files that are not found in the final dialog. This prevents the wizard from generating, or asking to generate, files. - Click Yes to compile. Click OK to save your project group.
The generated resource DLL projects contain untranslated copies of the resource strings from your original project.
To remove a language from a project
- Open your project.
- Select Project > Languages > Remove.
- Clear the check box next to the language that you want to remove and then click Next.
- Click Finish.
The wizard removes the selected resource DLL project from your main project file, but does not delete the files and directories in which they reside.
To restore a language to a project
- With your project opened in the IDE, choose File > New > Other > Delphi Projects (or C++Builder Projects) > Resource DLL Wizard to open the Resource DLL Wizard. Otherwise, choose Project > Languages > Add to open the Add Languages dialog box.
- On the appropriate page, select the base language project in which to restore the resource DLL projects for the languages to localize. Click Next.
- On the next page, select the languages (for example
Afrikaans
) for which to restore the resource DLL projects. Click Next. - The next page shows the selected languages and the default paths of the resource DLL projects for these languages. You can edit these default paths. Here you need to specify the directory path of the old resource DLL project. Click a path, an ellipsis button (...) appears and the in-place editor activates. You can click the ellipsis button to open the Browse For Folder dialog box. In this dialog box you can browse for the desired folder and click OK to select it. Click Next.
- The next page shows the selected languages and the Update Mode for corresponding resource DLL projects.
- If the path selected on the previous step points at the existing resource DLL project, which were previously deleted from the base language project, then the Update Mode shows
Update
. Such resource DLL project can be restored to the base language project. The existing resource DLL project will be updated to embed the modifications implemented in the resources of the base project. If you click in the Update Mode column and choose Overwrite, then the wizard deletes the existing old resource DLL project and any translations it contains and creates a new project. - If the path does not point at the existing resource DLL project, then the Update Mode shows
Create new
.
- If the path selected on the previous step points at the existing resource DLL project, which were previously deleted from the base language project, then the Update Mode shows
- Click Next.
- On the next page, click Finish.