生成语言翻译文件
要生成多语言界面相关的翻译文件,除了之前所说的在对每个字符串都使用tr()函数封装之外,还需要在项目配置文件(.pro文件)中使用TRANSLATIONS定义语言翻译文件(.ts文件),并使用lupdate工具生成语言翻译文件。
创建sampTr作为多语言界面设计实例。在项目的配置文件中增加如下的设置语句:
TRANSLATIONS =sampTr_cn.ts\
sampTr_en.ts
这里设置生成两个语言翻译文件“sampTr_cn.ts”和“sampTr_en.ts”,分别是中文和英文翻译文件。文件名称可以任意设计,只要有所区分即可。
原始的程序设计采用中文。为了便于进行语言切换,在主窗口上设置了两个工具栏按钮,分别用于切换中文和英文界面(如下图所示),界面语言切换的代码实现会在下一小节介绍。
为了让lupdate工具能提取项目代码内的字符串,这里对项目程序里的字符串全部采用tr()函数封装,
void MainWindow::on_btnStart_clicked()
{
ui->plainTextEdit->appendPlainText(tr("点击了开始按钮"));
}
void MainWindow::on_btnStop_clicked()
{
ui->plainTextEdit->appendPlainText(tr("点击了结束按钮"));
}
在项目设计期间,任何时候都可以使用lupdate工具生成或更新翻译文件,方法是单击Qt Creator主菜单的“Tools”一“External”一“Qt语言家”一“Update Translations(lupdate)”菜单项,若项目的源程序目录下没有sampTr_cn.ts和sampTr_en.ts这两个文件,就会自动生成,如果文件已经存在,则会更新这两个文件的内容。
使用Qt Linguist翻译ts文件
生成的sampTr_cn.ts和sampTr_en.ts文件内包含了项目源程序和UI界面里的所有字符串,使用Qt Linguist可以将这些字符串翻译为需要的语言版本。在Qt安装后的程序组里可以找到Qt Linguist软件。
sampTr_cn.ts是中文界面的翻译文件,由于源程序的界面就是用中文设计的,所以无需再翻译。sampTr_en.ts是英文翻译文件,需要将提取的所有中文字符串翻译为英文。
在Linguist软件中打开文件sampTr_en.ts,如下图所示的。可以通过Linguist主菜单的“编辑”一“翻译文件设置”菜单项调出语言设置对话框,用于设置目标语言和所在国家和地区。sampTr_en.ts是用于英文界面的翻译文件,所以选择语言“English”,国家/地区可选择“UnitedStates”。
左侧“上下文”列表里列出了项目中的所有窗口或类,这个项目有1个窗口。“字符串”列表里列出了从项目的UI窗口和代码文件中提取的字符串,右侧“短语和表单”会显示窗口界面的预览或字符串在源程序中出现的代码段。
在“字符串”列表中选择一个源文后,在下方会出现译文编辑框,在此填写字符串对应的英文译文。Linguist可以同时打开项目的多个ts文件,在选中一个源文后,在下方会出现对应的多个语言的译文编辑框,可以同时翻译为多个语言版本。
生成qm文件
使用Linguist软件编辑翻译文件,将所有字符串都翻译后,在Qt Creator中单击主菜单项“Tools”—“External”—“Qt 语言家—“Release Translations(lrelease)’’,会在项目源程序目录下生成与ts文件对应的qm文件,这是更为紧凑的翻译文件。本实例生成的是sampTr_cn.qm和sampTr_en.qm。
项目启动时设置界面语言
使用QTranslator类设置界面的不同语言版本,需在应用程序启动时设置界面语言翻译文件,即在main()函数中进行处理。项目sampTr的main.cpp的代码如下:
#include "mainwindow.h"
#include <QApplication>
#include <QTranslator>
#include <QSettings>
QTranslator *trans=NULL;
QString readSetting();
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
trans=new QTranslator;
QString curLang=readSetting(); //读取语言设置
if (curLang=="EN")
trans->load("sampTr_en.qm");
else
trans->load("sampTr_cn.qm");
a.installTranslator(trans);
MainWindow w;
w.show();
return a.exec();
}
QString readSetting()
{//从注册表读取上次设置的语言
QString organization="FutureRaider";
QString appName="sampTr";
QSettings settings(organization,appName);
QString Language=settings.value("Language","EN").toString();
return Language;
}
这里定义了一个全局变量trans,在main.cpp里定义了一个函数readSetting(),用于从注册表里读取上次设置的界面语言版本。注册表里数据的读取和写入使用到QSettings类。
在main()函数中,创建QTranslator类的对象trans后,调用readSetting()函数从注册表里读取上次的语言版本,若为“EN”,就用load()函数载入编译后的英文翻译文件sampTr_en.qm,否则就载入中文翻译文件sampTr_cn.qm。然后再执行a.installTranslator(trans),就可以给应用程序安装翻译器,实现需要的界面版本。
将sampTr_en.qm和sampTr_cn.qm文件这两个文件复制到可执行文件目录下。
在main()函数里加载翻译器是相比之下一劳永逸的方法,这样一来,随后应用程序的任何窗口都会自动应用开始设置的语言。所以,一些大型的软件在重新设置了语言版本后,通常都会要求重新启动软件才生效。
动态切换语言
在软件运行时可以动态切换语言,即无需重启软件就可以切换界面语言。在sampTr的主窗口上有“中文”和“English”两个工具栏按钮,用于实现中文和英文界面的切换。下面是这两个按钮的响应代码:
void MainWindow::on_actEn_triggered()
{//英文界面
qApp->removeTranslator(trans);
delete trans;
trans=new QTranslator;
trans->load("sampTr_en.qm");
qApp->installTranslator(trans);
ui->retranslateUi(this) ; //刷新界面字符串
QSettings settings("FutureRaider","sampTr");
settings.setValue("Language", "EN");
}
void MainWindow::on_actCh_triggered()
{//中文界面
qApp->removeTranslator(trans);
delete trans;
trans=new QTranslator;
trans->load("sampTr_cn.qm");
qApp->installTranslator(trans);
ui->retranslateUi(this) ; //刷新界面字符串
QSettings settings("FutureRaider","sampTr");
settings.setValue("Language", "CN");
}
一个应用程序只能加载一个翻译器,因为在main()函数里己经加载了一个翻译器,所以需要先移除当前的翻译器,才能重新创建新的翻译器,加载翻译文件,并为应用程序重新加载新翻译器。
完成这些后还必须调用UI的retranslateUi()函数来刷新界面。
retranslateUi()函数是在窗口的“ui_”头文件中自动生成的,如mainwindow.ui主窗口对应的头文件ui_mainwindow.h里就有函数retranslateUi(),这个函数使用QApplication::translate()函数将所有界面字符串进行翻译,类似于tr()函数的功能。
窗口在被创建时会自动调用此retranslateUi()函数,在程序运行中动态切换界面语言时,必须手工调用此retranslateUi()函数,才可以立即更新界面语言。
若不是用UI Designer设计的窗口,而是完全由代码实现的窗口界面,需要专门设计一个retranslateUi()函数,将所有界面字符串用tr()函数进行翻译,并在动态切换语言时调用此函数。很显然,这样做比较麻烦,特别是当软件比较大,窗口非常多时。所以,大型的软件在重新设置语言版本后,一般要求重新启动软件才生效,在程序启动时根据上次的设置加载一次翻译器即可。按钮响应代码的最后是将设置的语言版本写入注册表,以便下次程序启动时自动加载相应的语言。
————————————————
觉得有用的话请关注点赞,谢谢您的支持!
对于本系列文章相关示例完整代码有需要的朋友,可关注并在评论区留言!