碼上歡樂
相關內容    簡體    繁體

Qt 編寫應用支持多語言版本--一個GUI應用示例

本文轉載自   查看原文   2019-06-13 16:29   650    qt/ lupdate/ lrelease/ 語言家

簡介

上一篇博文已經說過如何編寫支持多語言的Qt 命令行應用，這一篇說說Qt GUI 應用多語言支持的坑。

本人喜歡用代碼來寫布局，而不是用 Qt Designer 來設計布局，手寫布局比 Qt Desiner 布局有以下優點：

  1. 手工布局，所想即所見，
  2. 源代碼方式修改布局非常方便，只需要拷貝代碼、注釋代碼就行，如果用 Qt Designer 修改原有布局，簡直要人老命，拖放一下 widget 就會打亂了原有的 layout；

本文示例程序是一個GUI應用，手寫布局，在工具欄中添加兩個 QAction，可以切換中文、英文界面，主界面一個標簽顯示文本，一個按鈕用來退出應用。

英文界面如下：

中文界面如下：

開發環境及步驟

VS 版本： vs2017 社區版
Qt 版本： 5.11.1
Qt VS tools: 2.3.2

第一步 新建 HelloQt 工程

默認的會創建 UI 文件，直接編譯工程，復制編譯產生的 ui_HelloQt.h 文件，重命名為 myUI_HelloQt.h 以這個文件為模板，手工布局。

第二步 在 setupUI() 中實現布局

使用MVC編程模型，只在 myUI_HelloQt.h 文件中實現GUI，這里雖然新建了兩個 QAction 和一個 QPushButton ，但是沒有連接信號和槽函數。

布局完成調試看看是否布局合理。

第三步 翻譯並添加到資源

  1. 新建翻譯文件 helloqt_zh.ts；

  2. 用工具 lupdate 提取字符串，並語言家來翻譯；

  3. 用工具 lrelease 發布 QM 文件，即 helloqt_zh.qm 文件；

  4. 在資源文件 HelloQt.qrc 中添加 QM 文件，並把資源重命名為 :/translations/helloqt_zh
    如圖所示：

    上面的步驟只是准備了翻譯字符串，實際上應用程序並不能切換語言，還需要執行下面的步驟：

  5. 新建一個成員變量 QTranslator *language_zh;，並在主窗口的構造方法中加載對應的QM文件， language_zh->load(":/translations/helloqt_zh");

  6. 加載了 QM 文件還不能切換多語言，需要安裝才行。到底何時安裝呢？這時候想起了前面的兩個 QAction，只有點擊了對應的工具條才切換對應的語言，在主窗口的構造方法中連接信號和槽函數:

            // signals and slots
    QObject::connect(ui.act_language_zh, SIGNAL(triggered(bool)), this, SLOT(on_trigger_language_zh(bool)));
	    QObject::connect(ui.act_language_en, SIGNAL(triggered(bool)), this, SLOT(on_trigger_language_en(bool)));
        QObject::connect(ui.btn_quit, SIGNAL(clicked(bool)), this, SLOT(on_btn_quit_clicked(bool)));

  7. 分別實現 action 對應的槽函數，加載中文時安裝 QTranslation，加載英文時卸載，如下面的代碼所示：

    void HelloQt::on_trigger_language_zh(bool checked)
{
    qDebug() << tr("Chinese") << endl;
    qApp->installTranslator(language_zh);
}

void HelloQt::on_trigger_language_en(bool checked)
{
    qDebug() << tr("English") << endl;
    qApp->removeTranslator(language_zh);
}

  8. 執行完上一步你就急着編譯查看結果，點擊兩個工具欄你卻發現並不能切換語言，為什么呢？因為切換語言的事件還沒有處理呢。覆蓋 changeEvent() 即可：

    void HelloQt::changeEvent(QEvent *event)
{
    if (event->type() == QEvent::LanguageChange) {
	    ui.retranslateUi(this);
        } else {
	    QMainWindow::changeEvent(event);
    }
}

至此兩個工具欄終於可以正常地切換語言顯示了。

深入一點

你可以看到工程中至少出現了3次 retranslateUi() 函數，一次是定義，兩次是調用，第一次調用是在UI 初始化中，第二次調用是 changeEvent() 中切換語言，它所做的工作就是把UI widgets 上顯示的字符串替換為特定語言的字符串。例如給主窗口設定窗口標題 HelloQtClass->setWindowTitle(QApplication::translate("HelloQtClass", "HelloQt", nullptr)); 最關鍵的是里面的 [static] QString QCoreApplication::translate(const char *context, const char *sourceText, const char *disambiguation = nullptr, int n = -1)，這個函數才是負責翻譯語言的。

第一個參數 context 理解為上下文，什么是上下文，Qt 助手說它就是一個類名。不同的字符串會分配到不同的上下文。分配規則是 tr() 是用哪個類名來限定的，如下面的代碼，分別調用 QObject::tr("install Chinese")，HelloQt::tr("install English") 那么就有兩個上下文，分別是 QObject 和 HelloQt，這一點也可以從語言家看到。

void HelloQt::on_trigger_language_zh(bool checked)
{
	qDebug() << QObject::tr("install Chinese") << endl;
	qApp->installTranslator(language_zh);
}

void HelloQt::on_trigger_language_en(bool checked)
{
	qDebug() << HelloQt::tr("install English") << endl;
	qApp->removeTranslator(language_zh);
}

語言家界面的顯示：

第二個參數 sourceText 就是源代碼中以 tr() 括起來的字符串。

后面的兩個參數暫時沒有用到，忽略。

一張圖說明上下文，源字符串二者的關系，如果代碼中某個字符串被刪除了但是 TS 文件中還存在，而且今后不需要這個翻譯，就可以用記事本打開 TS 文件，直接刪除以 vanished 標記的翻譯：

回到 retranslateUi() 函數，這是一個自定義的函數，用戶在這里翻譯GUI界面，如果發現GUI上某個 widget 語言沒有變化，就需要在這里翻譯，如下面的代碼翻譯標簽和按鈕的文本，以及兩個工具欄的文本：

```C++
    // add your own translate here.
    act_language_zh->setText(QApplication::translate("QObject", "Chinese", nullptr));
    act_language_en->setText(QApplication::translate("QObject", "English", nullptr));
    lbl_hello->setText(QApplication::translate("QObject", "<h2><i>Hello</i><font color=red>Qt!</font></h2>", nullptr));
    btn_quit->setText(QApplication::translate("QObject", "&Quit", nullptr));
```

上面的代碼中標簽文本是一個 HTML 代碼，這個也可以翻譯的， HTML 樣式保留，只需要替換里面的 Hello 和 Qt! 即可。

源代碼

只列出關鍵的源代碼，首先是布局文件 myUI_HelloQt.h

#pragma once
#ifndef MYUI_HELLOQT_H
#define MYUI_HELLOQT_H

#include <QtCore/QVariant>
#include <QtWidgets/QApplication>
#include <QtWidgets/QMainWindow>
#include <QtWidgets/QMenuBar>
#include <QtWidgets/QStatusBar>
#include <QtWidgets/QToolBar>
#include <QtWidgets/QWidget>
#include <QtWidgets/QMenu>
#include <QtWidgets/QAction>
#include <QtWidgets/QLabel>
#include <QtWidgets/QPushButton>
#include <QtWidgets/QVBoxLayout>

QT_BEGIN_NAMESPACE

class Ui_HelloQtClass
{
public:
	QMenuBar *menuBar;
	QToolBar *mainToolBar;
	QWidget *centralWidget;
	QStatusBar *statusBar;
	QAction *act_language_zh;
	QAction *act_language_en;
	QLabel *lbl_hello;
	QPushButton *btn_quit;


	void setupUi(QMainWindow *HelloQtClass)
	{
		if (HelloQtClass->objectName().isEmpty())
			HelloQtClass->setObjectName(QStringLiteral("HelloQtClass"));
		//HelloQtClass->resize(600, 400);
		HelloQtClass->setFixedSize(400, 160);
		menuBar = new QMenuBar(HelloQtClass);
		menuBar->setObjectName(QStringLiteral("menuBar"));
		HelloQtClass->setMenuBar(menuBar);
		mainToolBar = new QToolBar(HelloQtClass);
		mainToolBar->setObjectName(QStringLiteral("mainToolBar"));
		HelloQtClass->addToolBar(mainToolBar);
		centralWidget = new QWidget(HelloQtClass);
		centralWidget->setObjectName(QStringLiteral("centralWidget"));

		// add actions here.
		act_language_zh = new QAction(QObject::tr("Chinese"), HelloQtClass);
		act_language_en = new QAction(QObject::tr("English"), HelloQtClass);
		mainToolBar->addAction(act_language_zh);
		mainToolBar->addAction(act_language_en);

		// add your widgets here.
		lbl_hello = new QLabel(HelloQtClass);
		lbl_hello->setText(QObject::tr("<h2><i>Hello</i><font color=red>Qt!</font></h2>"));
		lbl_hello->setAlignment(Qt::AlignHCenter);
		
		btn_quit = new QPushButton(QObject::tr("&Quit"), HelloQtClass);
				
		QVBoxLayout *vLayout = new QVBoxLayout;
		vLayout->addWidget(lbl_hello);
		vLayout->addWidget(btn_quit);
		centralWidget->setLayout(vLayout);

		HelloQtClass->setCentralWidget(centralWidget);
		statusBar = new QStatusBar(HelloQtClass);
		statusBar->setObjectName(QStringLiteral("statusBar"));
		HelloQtClass->setStatusBar(statusBar);

		retranslateUi(HelloQtClass);

		QMetaObject::connectSlotsByName(HelloQtClass);
	} // setupUi

	void retranslateUi(QMainWindow *HelloQtClass)
	{
		// NOTE: the first parameter `context` in translate() must match the `context` in Qt Linguist.
		// [static] QString QCoreApplication::translate(const char *context, const char *sourceText, const char *disambiguation = nullptr, int n = -1)
		HelloQtClass->setWindowTitle(QApplication::translate("HelloQtClass", "HelloQt", nullptr));

		// add your own translate here.
		act_language_zh->setText(QApplication::translate("QObject", "Chinese", nullptr));
		act_language_en->setText(QApplication::translate("QObject", "English", nullptr));
		lbl_hello->setText(QApplication::translate("QObject", "<h2><i>Hello</i><font color=red>Qt!</font></h2>", nullptr));
		btn_quit->setText(QApplication::translate("QObject", "&Quit", nullptr));
	} // retranslateUi

};

namespace Ui {
	class HelloQtClass : public Ui_HelloQtClass {};
} // namespace Ui

QT_END_NAMESPACE

#endif // MYUI_HELLOQT_H

然后是 HelloQt.h

#pragma once

#include <QtWidgets/QMainWindow>
#include <QTranslator>
#include "myUI_HelloQt.h"

class HelloQt : public QMainWindow
{
	Q_OBJECT

public:
	HelloQt(QWidget *parent = Q_NULLPTR);

public slots:
	void on_trigger_language_zh(bool checked);
	void on_trigger_language_en(bool checked);

protected slots:
	void on_btn_quit_clicked(bool clicked);
	

protected:
	void changeEvent(QEvent *event) override;

private:
	Ui::HelloQtClass ui;
	QTranslator *language_zh;
};

然后是 HelloQt.c

#include <QDebug>
#include "HelloQt.h"

HelloQt::HelloQt(QWidget *parent)
	: QMainWindow(parent)
{
	ui.setupUi(this);
	
	// load translation
	language_zh = new QTranslator(this);
	language_zh->load(":/translations/helloqt_zh");

	// signals and slots
	QObject::connect(ui.act_language_zh, SIGNAL(triggered(bool)), this, SLOT(on_trigger_language_zh(bool)));
	QObject::connect(ui.act_language_en, SIGNAL(triggered(bool)), this, SLOT(on_trigger_language_en(bool)));
	QObject::connect(ui.btn_quit, SIGNAL(clicked(bool)), this, SLOT(on_btn_quit_clicked(bool)));
}

void HelloQt::on_trigger_language_zh(bool checked)
{
	qDebug() << QObject::tr("install Chinese") << endl;
	qApp->installTranslator(language_zh);
}

void HelloQt::on_trigger_language_en(bool checked)
{
	qDebug() << HelloQt::tr("install English") << endl;
	qApp->removeTranslator(language_zh);
}

void HelloQt::on_btn_quit_clicked(bool clicked)
{
	qApp->quit();
}

//************************************
// Method:    changeEvent
// FullName:  HelloQt::changeEvent
// Access:    protected 
// Returns:   void
// Qualifier:
// Parameter: QEvent * event
// Description: change language.
//************************************
void HelloQt::changeEvent(QEvent *event)
{
	if (event->type() == QEvent::LanguageChange) {
		ui.retranslateUi(this);
	} else {
		QMainWindow::changeEvent(event);
	}
}

然后是翻譯文件 helloqt_zh.ts

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE TS>
<TS version="2.1" language="zh_CN">
<context>
    <name>HelloQt</name>
    <message>
        <location filename="HelloQt.cpp" line="27"/>
        <source>install English</source>
        <oldsource>English</oldsource>
        <translation>安裝英文</translation>
    </message>
</context>
<context>
    <name>HelloQtClass</name>
    <message>
        <location filename="myUI_HelloQt.h" line="80"/>
        <source>HelloQt</source>
        <translation>你好Qt</translation>
    </message>
</context>
<context>
    <name>QObject</name>
    <message>
        <location filename="myUI_HelloQt.h" line="49"/>
        <location filename="myUI_HelloQt.h" line="83"/>
        <source>Chinese</source>
        <translation>中文</translation>
    </message>
    <message>
        <location filename="myUI_HelloQt.h" line="50"/>
        <location filename="myUI_HelloQt.h" line="84"/>
        <source>English</source>
        <translation>英文</translation>
    </message>
    <message>
        <location filename="myUI_HelloQt.h" line="56"/>
        <location filename="myUI_HelloQt.h" line="85"/>
        <source>&lt;h2&gt;&lt;i&gt;Hello&lt;/i&gt;&lt;font color=red&gt;Qt!&lt;/font&gt;&lt;/h2&gt;</source>
        <translation>&lt;h2&gt;&lt;i&gt;你好&lt;/i&gt;&lt;font color=red&gt;Qt!&lt;/font&gt;&lt;/h2&gt;</translation>
    </message>
    <message>
        <location filename="myUI_HelloQt.h" line="59"/>
        <location filename="myUI_HelloQt.h" line="86"/>
        <source>&amp;Quit</source>
        <translation>&amp;退出</translation>
    </message>
    <message>
        <location filename="HelloQt.cpp" line="21"/>
        <source>install Chinese</source>
        <translation>安裝中文</translation>
    </message>
</context>
</TS>

然后是資源文件 HelloQt.qrc

<RCC>
    <qresource prefix="/translations">
        <file alias="helloqt_zh">helloqt_zh.qm</file>
    </qresource>
</RCC>

聲明

歡迎轉載，請注明出處和作者，同時保留聲明。
作者：LinTeX9527
出處：https://www.cnblogs.com/LinTeX9527/p/11015060.html
本博客的文章如無特殊說明，均為原創，轉載請注明出處。如未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文連接，否則保留追究法律責任的權利。


免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。



猜您在找 MVC多語言應用 前端多語言版本方案。 Qt 多語言支持 js通過google翻譯插件實現多語言版本 Win10 UWP 開發系列：使用多語言工具包讓應用支持多語言 Android的應用多語言開發 Android 應用內多語言切換 SAP國際版本啟用及其他多語言版本的設置解析 Qt 的多語言支持的翻譯機制 一步一步實現網站的多語言版本
 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM