C++ Builder 基础知识C++ Builder 编程技巧

C++ Builder 本地化 (多语言) 功能

2022-01-03  本文已影响0人  玄坴

C++ Builder 参考手册 ➙ 本地化 (多语言) 功能

本文介绍 C++ Builder 自带的本地化 (多语言) 功能

  1. C++ Builder 自带的多语言功能简介
    1.1. 实现多语言的方式
    1.2. 发现的问题
  2. 创建一个 VCL 项目，添加多语言功能
    2.1. 创建一个 VCL 项目
    2.2. 添加语言 (英语)
    2.3. 翻译语言 (中文到英语)
    2.4. 英语/中文界面测试
    2.5. 程序实现切换语言功能
    2.6. 在隐藏的控件里面做可以切换语言的字符串
    2.7. 在 .rc 文件里面做可以切换语言的字符串

1. C++ Builder 自带的多语言功能简介

这是 C++ Builder 自带的，也是 RAD Studio (包括 Delphi 和 C++ Builder) 自身的多语言实现的方式。

1.1. 实现多语言的方式

1.2. 发现的问题

2. 创建一个 VCL 项目，添加多语言功能

2.1. 创建一个 VCL 项目

选择菜单 File -- New -- Windows VCL Application - C++ Builder 创建一个新的 VCL 项目，然后添加几个控件，用于测试多语言功能：

新创建一个 VCL 项目

把这个项目保存到新创建的项目文件夹里面，项目名称为 TestLocalization：

新创建的 VCL 项目文件

2.2. 添加语言 (英语)

Project -- Languages -- Add... Add Languages

选择添加语言的项目，默认就是当前的项目，基础语言 (Base Language) 为当前操作系统默认的语言 0804 就是简体中文，这是应用程序自身的语言 (可以点击选择更换基础语言)，直接点击 "Next >" 按钮进行下一步：

选择多语言支持的语言

选择多语言支持的语言，可以多选，每个语言将生成一个对应的 dll 项目，可以编译为 dll 语言 (资源) 文件，Local ID 为语言的 LCID，Extension 为语言文件的后缀，美国英语对应的是 .ENU 后缀名。选择语言之后，点击 "Next >" 按钮进行下一步：

生成的项目文件存放位置

这是项目文件存放位置，可以点击 Path 栏里面的路径更改保存位置，默认就在要添加语言项目的文件夹里面，创建语言后缀名相同的名称的文件夹里面，点击 "Next >" 按钮继续：

创建新的语言项目

这是语言的状态，"英语 (美国)" 的状态为 "Create New"
点击 "Next >" 继续：

添加新的语言

点击 "Finish" 结束添加语言。

是否重新编译

提示 Resource DLL Wizard 需要重新编译项目，选择 "Yes"

添加语言结束

添加语言结束：

新增了一个 TestLocalization.ENU 项目

可以看到新增了一个 TestLocalization.ENU 项目，这个项目可以编译生成 TestLocalization.ENU 文件，在 exe 相同文件夹里面，是美国英语的资源文件。

这时候，项目组 ProjectGroup1 也需要保存，如下截图：

项目组

选择 File - Save All 保存所有文件，或者点击工具栏上的 "Save All" 按钮：

Save All - 保存所有文件

将提示把项目组文件存盘，例如保存为 Localization.groupproj

把项目组文件存盘

以后再打开这个项目组文件，就会同事打开项目文件和所有的语言翻译 dll 项目

项目组

2.3. 翻译语言 (中文到英语)

双击英文翻译项目 TestLocalization.ENU 里面的 Unit1.dfm

翻译语言

打开的不是 Form 画面设计，而是这个 Form 的翻译，这里只需要翻译一些控件的标题或文字，如上截图的画圈部分：

翻译

可以看到，在 "英语 (美国)" 栏里面翻译了的项目，Status 栏自动变成了 Translated，表示 "已经翻译"，而其他没有翻译的，是 Untranslated 即 "没翻译"，那些项目也不需要翻译。

保存翻译

点击翻译表格左上角的保存按钮，把翻译内容存盘，如上截图画圈的按钮位置。

编译语言项目：

编译 TestLocalization.

在 TestLocalization.ENU 项目点击右键，选择 Make，或者选择菜单 Project - Make all projects 编译所有项目。

会在 TestLocalization.exe 相同文件夹里面生成 TestLocalization.ENU 文件，即为英语资源文件。

2.4. 英语/中文界面测试

直接运行项目，和添加语言之前没有区别，是设计时的中文界面：

直接运行：中文界面

选择菜单：Project -- Languages -- Set Active...

剪貼簿23.png 选择 "英语 (美国)"

选择 "英语 (美国)"，然后点击 "Finish" 按钮。

再运行程序，就变成英文界面了：

运行：英文界面

这里 "中文" 按钮在语言翻译表格里面没有翻译为英文，所以切换到英文界面也是 "中文"，这有助于切换到一个陌生的语言再切换回去。

如果要切换到中文界面，再选择一次菜单：Project -- Languages -- Set Active... ，选择 "中文 (简体，中国)" 就可以了。

2.5. 程序实现切换语言功能

前面内容演示了如何测试多语言界面，但是程序发布的时候，要在程序里面切换语言，而不是在编译器里面切换。

这个演示程序里面：Button1 是 "English"，Button2 是 "中文"，现在实现这两个按钮的功能。

由于需要修改注册表，所以加入了头文件 #include <System.Win.Registry.hpp>

#include <System.Win.Registry.hpp>

注册表位置：HKEY_CURRENT_USER\Software\Embarcadero\Locales
注册表项：应用程序的完整路径和文件名，即 Application->ExeName
如果注册表项的值为 "ENU"，程序运行时会加载与 exe 文件同名的后缀为 .ENU 的资源 dll 文件；把注册表项的值改为 CHS，即简体中文，应用程序运行时找不到后缀为 .CHS 的资源文件，就不加载资源文件了，使用设计界面时的默认文字，即简体中文。

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    TRegistry *reg = new TRegistry;
    reg->RootKey = HKEY_CURRENT_USER;
    reg->OpenKey(L"Software\\Embarcadero\\Locales", true);
    reg->WriteString(Application->ExeName, L"ENU");
    reg->CloseKey();
    delete reg;
    ShowMessage(L"语言已经更改，关闭程序重新运行将使用更改之后的语言。");
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
    TRegistry *reg = new TRegistry;
    reg->RootKey = HKEY_CURRENT_USER;
    reg->OpenKey(L"Software\\Embarcadero\\Locales", true);
    reg->WriteString(Application->ExeName, L"CHS");
    reg->CloseKey();
    delete reg;
    ShowMessage(L"语言已经更改，关闭程序重新运行将使用更改之后的语言。");
}

更改语言，即修改注册表项之后，需要退出重新运行，才能生效。

由于修改了程序，所以要更新语言翻译的项目，才能在切换到非默认的语言里面生效：选择菜单 project -- Languages -- Update Localized Projects 更新本地化项目：

更新本地化项目

选择之后，即没有成功的提示，也没有失败的提示，就是没有问题了，然后要重新编译所有的项目：选择菜单 Project -- Make All Projects
这样修改程序在所有的语言都生效了。

例如运行在英文界面，点击 "中文" 按钮，有如下提示：

在英文界面，点击 "中文"

退出、重新运行：

切换到了中文界面

2.6. 在隐藏的控件里面做可以切换语言的字符串

由于刚才的例子，在 C++ 代码里面有字符串：

ShowMessage(L"语言已经更改，关闭程序重新运行将使用更改之后的语言。");

这样的字符串不能被语言翻译向导收录并自动切换语言，而需要想其他办法，用隐藏的控件的文字来翻译 (例如 Label 的 Caption 属性) 就是一个办法。如果要翻译的文字很多，可以把所有这些 Label 放在一个 Panel 里面，Panel 隐藏 (Visible 属性设为 false)。

Label3 放在隐藏的 Panel1 里面

以上截图：Panel1 的 Visible 属性设为 false 专门用来放翻译用的字符串的，里面的 Label3 的 Caption 设为 ShowMessage 的提示信息。

把 ShowMessage(L"语言已经更改，关闭程序重新运行将使用更改之后的语言。");
改为 ShowMessage(Label3->Caption);
就可以应用翻译了。

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    TRegistry *reg = new TRegistry;
    reg->RootKey = HKEY_CURRENT_USER;
    reg->OpenKey(L"Software\\Embarcadero\\Locales", true);
    reg->WriteString(Application->ExeName, L"ENU");
    reg->CloseKey();
    delete reg;
    ShowMessage(Label3->Caption); // L"语言已经更改，关闭程序重新运行将使用更改之后的语言。"
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
    TRegistry *reg = new TRegistry;
    reg->RootKey = HKEY_CURRENT_USER;
    reg->OpenKey(L"Software\\Embarcadero\\Locales", true);
    reg->WriteString(Application->ExeName, L"CHS");
    reg->CloseKey();
    delete reg;
    ShowMessage(Label3->Caption); // L"语言已经更改，关闭程序重新运行将使用更改之后的语言。"
}

由于更改了程序，仍然需要

翻译 Label3->Caption 英文效果 中文效果

2.7. 在 .rc 文件里面做可以切换语言的字符串

在项目里面添加 TestLocalization_res.rc 文件

在项目里面添加一个 TestLocalization_res.rc 文件，内容如下：

STRINGTABLE
BEGIN
  101 "语言已经更改，关闭程序重新运行将使用更改之后的语言。"
END

这是 ID 为 101 的字符串内容

由于更改了程序，仍然需要

选择菜单 project -- Languages -- Update Localized Projects 更新本地化项目

剪貼簿34.png

更新之后，在语言项目里面也会增加一个 TestLocalization_res.rc 文件，双击这个文件，出现的是翻译表格。

翻译、存盘

仍然是把 "英语 (美国)" 栏的内容翻译之后，点击表格左上角的存盘按钮保存。

把 ShowMessage(L"语言已经更改，关闭程序重新运行将使用更改之后的语言。");
改为 ShowMessage(LoadStr(101)); 即使用 ID 为 101 的字符串

要重新编译所有的项目：选择菜单 Project -- Make All Projects
这样修改程序在所有的语言都生效了。

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    TRegistry *reg = new TRegistry;
    reg->RootKey = HKEY_CURRENT_USER;
    reg->OpenKey(L"Software\\Embarcadero\\Locales", true);
    reg->WriteString(Application->ExeName, L"ENU");
    reg->CloseKey();
    delete reg;
    ShowMessage(LoadStr(101)); // Label3->Caption // L"语言已经更改，关闭程序重新运行将使用更改之后的语言。"
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
    TRegistry *reg = new TRegistry;
    reg->RootKey = HKEY_CURRENT_USER;
    reg->OpenKey(L"Software\\Embarcadero\\Locales", true);
    reg->WriteString(Application->ExeName, L"CHS");
    reg->CloseKey();
    delete reg;
    ShowMessage(LoadStr(101)); // Label3->Caption // L"语言已经更改，关闭程序重新运行将使用更改之后的语言。"
}
运行：英文界面 运行：中文界面

相关：

C++ Builder 参考手册 ➙ 本地化 (多语言) 功能

上一篇 下一篇

猜你喜欢

热点阅读