Qt之国际化
简介
Qt国际化属于Qt高级中的一部分,本想着放到后面来说,上节刚好介绍了Qt Linguist,趁热打铁就一起了解下。
对于绝大多数的应用程序,在刚启动时,需要加载默认的语言(或最后一次设置的语言)。在使用的过程中,我们也不需要重启应用程序而实现语言的动态切换。这样的话,易用性就非常好了。
多语言切换
要进行多语言的切换,需要执行以下步骤:
对用户可见的文本信息全部使用tr()进行封装
提供用户可以用来切换语言的一种方法。
对于每一个窗口部件或者对话框,重写changeEvent事件,当事件类型为QEvent::LanguageChange时,翻译文本进行重新调用(为了简单我把它放在一个单独的函数translateUI()中)。
源码分析
我们来看一个简单的示例:主界面、设置界面,设置界面可根据选择不同语言下拉选项实现语言的动态切换!
为了简单起见,这里只给出关键代码(源码下载请参考最下面下载地址):
设置界面:setting_dialog.h
typedef enum{
UI_ZH,
UI_EN
}LANGUAGE;
Q_DECLARE_METATYPE(LANGUAGE)
设置界面:setting_dialog.cpp
language_combo_box->addItem("chinese", QVariant::fromValue(UI_ZH));
language_combo_box->addItem("english", QVariant::fromValue(UI_EN));
qRegisterMetaType<LANGUAGE>("LANGUAGE");
connect(language_combo_box, static_cast<void (QComboBox::*)(int)>(&QComboBox::currentIndexChanged), this, &SettingDialog::onIndexChanged);
void SettingDialog::changeEvent(QEvent *event)
{
switch (event->type())
{
case QEvent::LanguageChange:
translateUI();
break;
default:
QDialog::changeEvent(event);
}
}
void SettingDialog::translateUI()
{
this->setWindowTitle(tr("setting dialog"));
info_label->setText(tr("no brothers no programming"));
language_label->setText(tr("language"));
language_combo_box->setItemText(UI_ZH, tr("chinese"));
language_combo_box->setItemText(UI_EN, tr("english"));
}
void SettingDialog::onIndexChanged()
{
LANGUAGE language = language_combo_box->currentData().value<LANGUAGE>();
emit switchLanguage(language);
}
主界面:MainWidget.cpp
connect(setting_dialog, &SettingDialog::switchLanguage, this, &MainWidget::switchLanguage);
void MainWidget::translateUI()
{
this->setWindowTitle(tr("main widget"));
welcome_label->setText(tr("welcome to Qt") + QString("26197884/26188347"));
setting_button->setText(tr("setting"));
ok_button->setText(tr("ok"));
cancel_button->setText(tr("cancel"));
}
void MainWidget::setLanguage(LANGUAGE current_language)
{
this->current_language = current_language;
}
void MainWidget::setTranslator(QTranslator* translator)
{
this->translator = translator;
}
void MainWidget::changeEvent(QEvent *event)
{
switch (event->type())
{
case QEvent::LanguageChange:
translateUI();
break;
default:
QWidget::changeEvent(event);
}
}
void MainWidget::switchLanguage(LANGUAGE language)
{
QString language_qm;
switch(language)
{
case UI_ZH:
language = UI_ZH;
language_qm = QString(":/qm/main_widget_zh");
break;
case UI_EN:
language = UI_EN;
language_qm = QString(":/qm/main_widget_en");
break;
default:
language = UI_ZH;
language_qm = QString(":/qm/main_widget_zh");
}
if(current_language != language)
{
current_language = language;
translator->load(language_qm);
Util::writeInit(QString("./user.ini"), QString("language"), QString::number(language, 10));
}
}
main.cpp
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QString language_value;
QString language_suffix = QString("zh");
LANGUAGE language = UI_ZH;
bool is_read = Util::readInit(QString("./user.ini"), QString("language"), language_value);
if(is_read)
{
language = (LANGUAGE)language_value.toInt();
if(language == UI_EN)
{
language_suffix = QString("en");
}
}
QTranslator translator;
translator.load(QString(":/qm/main_widget_") + language_suffix);
app.installTranslator(&translator);
MainWidget main_widget;
main_widget.setTranslator(&translator);
main_widget.setLanguage(language);
main_widget.show();
return app.exec();
}
流程:
进入main(),首先加载默认的语言(或最后一次设置的语言),然后显示主界面。
当打开设置界面后,首先加载当前选择的语言,然后通过下拉设置语言选项来进行语言切换(设置界面的switchLanguage信号关联到主界面的switchLanguage槽中),然后将当前的语言进行保存。
语言切换后,首先会进入changeEvent函数,判断当事件类型为QEvent::LanguageChange时,就会执行translateUI函数进行文本重新显示。
注:
Q_DECLARE_METATYPE:如果要使自定义类型或其他非QMetaType内置类型在QVariant中使用,必须使用该宏 。
qRegisterMetaType:如果非QMetaType内置类型要在信号与槽中使用。
添加翻译源
为了方便,这里只介绍中、英文之间的切换。
在pro中添加:
TRANSLATIONS += Resource/main_widget_zh.ts \
Resource/main_widget_en.ts
选择:工具->外部->Qt语言家->更新翻译,则会生成对应的ts文件。
翻译
使用Qt Linguist打开要翻译的ts文件,对翻译源进行相应语言的翻译。
可参考:Qt Linguist介绍
发布翻译
选择:文件->发布,就会生成对应的qm文件。
加载翻译文件
使用QTranslator来加载生成的qm文件,就可以让程序显示指定的语言。
QTranslator translator;
translator.load(":/qm/main_widget_zh");
app.installTranslator(&translator);