Qt實(shí)現(xiàn)語言切換的完整指南

更新時(shí)間：2025年04月24日 09:26:14 作者：byxdaz

這篇文章主要為大家詳細(xì)介紹了如何在Qt中實(shí)現(xiàn)語言切換的完整指南,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

一、準(zhǔn)備工作

1.在代碼中使用tr()標(biāo)記所有需要翻譯的字符串

button->setText(tr("Submit"));

2.創(chuàng)建翻譯文件

在.pro文件中添加：

TRANSLATIONS = translations/myapp_zh_CN.ts \
              translations/myapp_en_US.ts

二、核心實(shí)現(xiàn)類

1. 語言管理器頭文件 (LanguageManager.h)

#ifndef LANGUAGEMANAGER_H
#define LANGUAGEMANAGER_H
 
#include <QObject>
#include <QTranslator>
#include <QMap>
 
class LanguageManager : public QObject
{
    Q_OBJECT
public:
    static LanguageManager* instance();
    
    // 可用語言列表
    QMap<QString, QString> availableLanguages() const;
    
    // 設(shè)置當(dāng)前語言
    void setCurrentLanguage(const QString& languageCode);
    
    // 獲取當(dāng)前語言
    QString currentLanguage() const;
 
signals:
    // 語言改變信號(hào)
    void languageChanged();
 
protected:
    explicit LanguageManager(QObject *parent = nullptr);
 
private:
    void loadTranslations();
    
    static LanguageManager* m_instance;
    QTranslator* m_appTranslator;
    QTranslator* m_qtTranslator;
    QString m_currentLanguage;
    QMap<QString, QString> m_languages; // <code, displayName>
};
 
#endif // LANGUAGEMANAGER_H

2. 語言管理器實(shí)現(xiàn) (LanguageManager.cpp)

#include "LanguageManager.h"
#include <QApplication>
#include <QDir>
#include <QDebug>
#include <QLibraryInfo>
#include <QSettings>
 
LanguageManager* LanguageManager::m_instance = nullptr;
 
LanguageManager::LanguageManager(QObject *parent) : QObject(parent)
{
    m_appTranslator = new QTranslator(this);
    m_qtTranslator = new QTranslator(this);
    
    // 初始化可用語言
    m_languages = {
        {"en_US", "English"},
        {"zh_CN", "簡(jiǎn)體中文"},
        {"ja_JP", "日本語"}
    };
    
    loadTranslations();
}
 
LanguageManager* LanguageManager::instance()
{
    if (!m_instance) {
        m_instance = new LanguageManager(qApp);
    }
    return m_instance;
}
 
QMap<QString, QString> LanguageManager::availableLanguages() const
{
    return m_languages;
}
 
void LanguageManager::setCurrentLanguage(const QString &languageCode)
{
    if (!m_languages.contains(languageCode) || m_currentLanguage == languageCode) {
        return;
    }
    
    // 加載應(yīng)用程序翻譯
    bool loadSuccess = m_appTranslator->load(QString(":/translations/myapp_%1.qm").arg(languageCode));
    
    if (loadSuccess) {
        QApplication::installTranslator(m_appTranslator);
        
        // 加載Qt基礎(chǔ)庫翻譯
        if (m_qtTranslator->load(QString("qt_%1").arg(languageCode), 
                               QLibraryInfo::location(QLibraryInfo::TranslationsPath))) {
            QApplication::installTranslator(m_qtTranslator);
        }
        
        m_currentLanguage = languageCode;
        
        // 保存到設(shè)置
        QSettings settings;
        settings.setValue("Language", languageCode);
        
        emit languageChanged();
    } else {
        qWarning() << "Failed to load translation for" << languageCode;
    }
}
 
QString LanguageManager::currentLanguage() const
{
    return m_currentLanguage;
}
 
void LanguageManager::loadTranslations()
{
    QSettings settings;
    QString lang = settings.value("Language", QLocale::system().name()).toString();
    
    // 如果設(shè)置的語言不可用，則使用系統(tǒng)語言或默認(rèn)英語
    if (!m_languages.contains(lang)) {
        lang = m_languages.contains(QLocale::system().name()) ? 
               QLocale::system().name() : "en_US";
    }
    
    setCurrentLanguage(lang);
}

三、使用示例

1. 主窗口實(shí)現(xiàn)

// MainWindow.h
#include <QMainWindow>
#include "LanguageManager.h"
 
namespace Ui {
class MainWindow;
}
 
class MainWindow : public QMainWindow
{
    Q_OBJECT
 
public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
 
protected:
    void changeEvent(QEvent *e) override;
 
private slots:
    void onLanguageChanged();
    void on_actionChinese_triggered();
    void on_actionEnglish_triggered();
 
private:
    Ui::MainWindow *ui;
    void updateUI();
};
 
// MainWindow.cpp
#include "MainWindow.h"
#include "ui_MainWindow.h"
 
MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    
    // 連接語言改變信號(hào)
    connect(LanguageManager::instance(), &LanguageManager::languageChanged,
            this, &MainWindow::onLanguageChanged);
    
    updateUI();
}
 
MainWindow::~MainWindow()
{
    delete ui;
}
 
void MainWindow::changeEvent(QEvent *e)
{
    QMainWindow::changeEvent(e);
    if (e->type() == QEvent::LanguageChange) {
        ui->retranslateUi(this);
        updateUI();
    }
}
 
void MainWindow::onLanguageChanged()
{
    // 語言改變后的處理
    updateUI();
}
 
void MainWindow::updateUI()
{
    // 更新非UI文件中的文本
    setWindowTitle(tr("Multilingual Application"));
    statusBar()->showMessage(tr("Current language: %1")
                            .arg(LanguageManager::instance()->currentLanguage()));
}
 
void MainWindow::on_actionChinese_triggered()
{
    LanguageManager::instance()->setCurrentLanguage("zh_CN");
}
 
void MainWindow::on_actionEnglish_triggered()
{
    LanguageManager::instance()->setCurrentLanguage("en_US");
}

2. 主函數(shù)初始化

#include <QApplication>
#include "MainWindow.h"
#include "LanguageManager.h"
 
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    
    // 初始化語言管理器
    LanguageManager::instance()->>setCurrentLanguage("zh_CN");
    
    MainWindow w;
    w.show();
    
    return a.exec();
}

四、說明

1.翻譯文件生成流程：

lupdate myproject.pro  # 生成.ts文件
linguist translations/myapp_zh_CN.ts  # 使用Qt Linguist翻譯
lrelease myproject.pro  # 生成.qm文件

資源文件(.qrc)配置：

<RCC>
    <qresource prefix="/">
        <file>translations/myapp_zh_CN.qm</file>
        <file>translations/myapp_en_US.qm</file>
    </qresource>
</RCC>

3.注意事項(xiàng)：

所有需要翻譯的字符串必須用tr()包裹

語言切換后，需要手動(dòng)更新動(dòng)態(tài)生成的文本

對(duì)于UI文件中的文本，retranslateUi()會(huì)自動(dòng)處理

考慮不同語言文本長(zhǎng)度對(duì)布局的影響

到此這篇關(guān)于Qt實(shí)現(xiàn)語言切換的完整指南的文章就介紹到這了,更多相關(guān)Qt語言切換內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: